JavaScript Promise Integration (JSPI) — это API, позволяющий синхронному последовательному коду, скомпилированному в WebAssembly, получать доступ к асинхронным веб-API. Многие веб-API построены на основе обещаний JavaScript: вместо того, чтобы немедленно выполнить запрошенную операцию, они возвращают обещание. Когда действие наконец выполняется, обработчик задач браузера вызывает все обратные вызовы с обещанием. JSPI подключается к этой архитектуре, позволяя приостанавливать выполнение приложения WebAssembly при возврате обещания и возобновлять его после его выполнения.
Начиная с Chrome 123 и до Chrome 128, JSPI доступен в качестве пробной версии . Подробнее о JSPI можно узнать в статье блога «Введение в API интеграции JavaScript Promise для WebAssembly» или в проекте спецификации .
Чтобы лучше понять, как использовать эту функцию, рассмотрим следующий фрагмент программы на языке 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
Вы можете определить поддержку JSPI из JavaScript следующим образом:
if ('Suspender' in WebAssembly) {
// JSPI is supported.
}
Чтобы опробовать JSPI с реальными пользователями вашего приложения, зарегистрируйтесь на пробную версию Origin . Если вам нужны инструкции, ознакомьтесь со статьей «Начало работы с пробными версиями Origin» . Команда JSPI с нетерпением ждет ваших отзывов о пробной версии Origin (см. шаг 5 в инструкциях), чтобы функция соответствовала вашим потребностям к моменту запуска!