JavaScript Promise Integration(JSPI)は、WebAssembly にコンパイルされた同期シーケンシャル コードが非同期 Web API にアクセスできるようにする API です。多くのウェブ API は JavaScript のプロミスの形で作成されています。リクエストされたオペレーションをすぐに実行するのではなく、実行するためのプロミスを返します。アクションが最終的に実行されると、ブラウザのタスク ランナーがプロミスでコールバックを呼び出します。JSPI はこのアーキテクチャにフックして、Promise が返されたときに WebAssembly アプリケーションを一時停止し、Promise が解決されたときに再開できるようにします。
Chrome 123 から Chrome 128 まで、JSPI はオリジン トライアルとして利用できます。JSPI について詳しくは、ブログ投稿の WebAssembly JavaScript Promise Integration API のご紹介または 仕様のドラフトをご覧ください。
この機能の使用方法をより深く理解するために、JavaScript 関数に加算をアウトソーシングしてフィボナッチ数列を計算する C プログラムの次の抜粋を検討してください。
// This is C code.
long promiseFib(long x) {
if (x == 0)
return 0;
if (x == 1)
return 1;
// This is where the C code calls asynchronous JavaScript.
return promiseAdd(promiseFib(x - 1), promiseFib(x - 2));
}
// Addition artificially wrapped in a Promise.
EM_ASYNC_JS(long, promiseAdd, (long x, long y), {
// This is asynchronous JavaScript code.
return Promise.resolve(x+y);
});
この C プログラムを WebAssembly にコンパイルするには、次のコマンドを使用します。このコマンドには Emscripten SDK が必要です。
emcc -O3 badfib.c -o index.html -s ASYNCIFY=2
JavaScript から JSPI のサポートを検出するには、次のようにします。
if ('Suspender' in WebAssembly) {
// JSPI is supported.
}
アプリケーションの実際のユーザーで JSPI を試すには、オリジン トライアルに登録します。手順については、オリジン トライアルを使ってみるをご覧ください。JSPI チームは、この機能がリリースされたときにニーズに合致するように、オリジン トライアルのフィードバック(手順のステップ 5 を参照)をお待ちしています。