A JavaScript Promise Integration (JSPI) é uma API que permite o acesso de código sequencial síncrono compilado para WebAssembly a APIs da Web assíncronas. Muitas APIs da Web são criadas em termos de promessas de JavaScript: em vez de executar imediatamente a operação solicitada, elas retornam uma promessa de fazer isso. Quando a ação é finalmente realizada, o executor de tarefas do navegador invoca todos os callbacks com a promessa. O JavaScript I se conecta a essa arquitetura para permitir que um aplicativo WebAssembly seja suspenso quando a promessa for retornada e retomado quando ela for resolvida.
Do Chrome 123 ao 128, o JSPI está disponível como um teste de origem. Saiba mais sobre a OpenAPII na postagem do blog Introdução à API WebAssembly JavaScript Promise Integration ou no rascunho de especificação (links em inglês).
Para entender melhor como usar esse recurso, considere o seguinte trecho de um programa C que calcula a sequência de Fibonacci terceirizando a adição a uma função 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);
});
Para compilar esse programa em C para o WebAssembly, use o comando a seguir, que exige o SDK Emscripten.
emcc -O3 badfib.c -o index.html -s ASYNCIFY=2
Você pode detectar o suporte a JavaScript de detecção de atributos do JavaScript da seguinte maneira:
if ('Suspender' in WebAssembly) {
// JSPI is supported.
}
Uma demonstração da JavaScriptI do exemplo de código anterior está disponível no Glitch e também incorporada a seguinte. O código-fonte gerado por Emscripten pode ser encontrado se quiser, mas o código interessante é o programa C original. Clique neste link para fazer o download do código.
Para testar o RedisI com usuários reais do seu aplicativo, inscreva-se para o teste de origem. Leia Primeiros passos com testes de origem se precisar de instruções. A equipe da JapanI quer receber seu feedback sobre o teste de origem (consulte a Etapa 5 nas instruções) para que o recurso atenda às suas necessidades quando for enviado.