WebAssembly JavaScript Promise Integration (JSPI) 進入來源試用

Thomas Steiner

JavaScript Promise 整合 (JSPI) 是一種 API，可讓編譯為 WebAssembly 的同步順序程式碼存取非同步 Web API。許多 Web API 都是以 JavaScript 承諾為基礎設計：這些 API 不會立即執行要求的作業，而是會傳回承諾來執行該作業。當作業最終執行時，瀏覽器的工作執行程式會使用承諾叫用任何回呼。JSPI 會連結至這個架構，在傳回承諾時暫停 WebAssembly 應用程式，並在解決承諾時恢復。

自 Chrome 123 到 Chrome 128 之間，JSPI 可做為來源試用。如要進一步瞭解 JSPI，請參閱網誌文章「Introducing the WebAssembly JavaScript Promise Integration API」或規格草稿。

如要進一步瞭解如何使用這項功能，請參考下列 C 程式碼摘錄，該程式碼會將加法外包給 JavaScript 函式，以便計算費氏數列。

// 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.
}

Glitch 提供上述程式碼範例的 JSPI 示範，也嵌入了以下內容。您可以查看 Emscripten 產生的原始碼 (點選這個連結即可下載程式碼)，但實際上有趣的程式碼是原始 C 程式。

如要讓應用程式的實際使用者試用 JSPI，請註冊原始版本的試用方案。如需操作說明，請參閱「開始進行來源試驗」。JSPI 團隊期待收到你在原始測試期間的意見回饋 (請參閱操作說明中的步驟 5)，以便在功能推出時滿足你的需求！