クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

WASI 0.2 と WASI 0.3 の違い

このレッスンのあとで: WASI 0.3 のインターフェースを 0.2 のものと見分け、何が変わったかを言える。

60分のレッスンコマンド3件WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

止まらずに待つ仕組みが組み込みに

2026年6月11日に承認された WASI 0.3 は、コンポーネントモデルにネイティブの非同期を加えます。関数を async にでき、ストリームとフューチャーが組み込みの型になりました。2024年1月に出た WASI 0.2 は、同じ仕事を pollable とストリームのリソースでこなしていました。

今日は、それぞれのバージョン向けに作ったコンポーネントを1つずつ動かし、何が変わったかを見ます。

このレッスンのゴール

メモ

WASI 0.3 のインターフェースを 0.2 のものと見分け、何が変わったかを言える。

キーワード

ことばいみれい
async 関数呼んだ側が終わりを待たなくてよい関数async func
ストリーム次々に届く値の流れstream<u8>
フューチャーあとで届く1つの値future<u32>
pollableWASI 0.2 で、待つ対象を表すハンドル
セマンティックバージョンmajor.minor.patch と書くバージョン0.3.0

学生が入力するセルは、このプレビューでは空白です。

WASI 0.2 の待ち方: pollable

WASI 0.2 では、ソケットやファイルを読むと input-stream というリソースが返ります。止まらずにバイトを待つには、ストリームに pollable を求め、それを poll に渡します。poll は、何かの準備ができたときに戻ります。

待つインターフェースごとに pollable が要ります。しかも言語ごとに、それを自分の非同期の仕組みへ手でつながなければなりません。

WASI 0.2 向けのものを動かす

コマンド
docker exec wasm wasmtime run --invoke 'ticking()' clock2.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

WASI 0.3 向けのものを動かす

コマンド
docker exec wasm wasmtime run --invoke 'ticking()' clock3.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

WASI 0.3 で変わったこと

WASI 0.3 は、待つことをコンポーネントモデルそのものに移しました。WIT に async func、stream<u8>、future<T> と書けます。ランタイムは呼び出しが待っていると分かるので、そのあいだに別のことを進められます。

インターフェースは短くなります。HTTP のハンドラーは、リクエストを受けてレスポンスを返す async 関数1つになります。Wasmtime はバージョン46で WASI 0.3 を既定で有効にしました。オプション -S p3=n で無効にできます。

例: 同じ仕事を2つの版で

仕事WASI 0.2WASI 0.3
バイトを待つinput-stream から pollable を得て pollstream<u8> を読む
しばらく眠る時計から得た pollable時計の async 関数
ウェブのリクエストに答えるハンドラーと、レスポンスを返す引数async 関数1つ。リクエストを受けてレスポンスを返す
2つの呼び出しを同時にpollable のリストを pollランタイムが async の呼び出しを並べて進める

学生が入力するセルは、このプレビューでは空白です。

WASI 0.3 を切ってもう一度

コマンド
docker exec wasm wasmtime run -S p3=n --invoke 'ticking()' clock3.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

よくある間違い

注意

「ホストが 0.3 に移ったら、WASI 0.2 のコンポーネントはすべてビルドし直しだ」と考える人がいます。ラボで見たとおり、Wasmtime は 0.3 のインターフェースの隣に 0.2 のものも用意します。ビルドし直すのは、async 関数やストリームを使いたいときだけです。

試そう: 交代で待つ2つの仕事

コード: python
import asyncio

async def fetch(name, steps):
    # await のたびに順番を返すので、そのあいだにもう一方が進みます。
    for n in range(steps):
        print(name, "が待っています。ステップ", n + 1)
        await asyncio.sleep(0)
    return name + " 完了"

async def main():
    results = await asyncio.gather(fetch("logs", 2), fetch("prices", 3))
    print(results)

asyncio.run(main())
# 3 を 1 に変えましょう。今度はどちらが先に終わるでしょうか。

このラボとソースについて: WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。