CKTIS / JavaScript
Promise.withResolvers(): uma promise com funções de resolução acessíveis
Promise.withResolvers() devolve uma nova promise e as funções resolve e reject associadas. Permite separar a criação da promise da indicação do seu resultado, por exemplo, ao adaptar uma interface baseada em callbacks.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const { promise, resolve, reject } = Promise.withResolvers();Promise.withResolvers() é um método estático do ECMAScript 2024, não uma API Web. Não recebe argumentos e devolve um objeto normal com as propriedades promise, resolve e reject. Com Promise.withResolvers(), a promise fica inicialmente à espera de um resultado; não se fornece uma função executora como em new Promise(executor).
resolve(value) aceita um valor ou adota o resultado futuro de uma promise ou de um thenable. Por isso, chamar resolve nem sempre significa que a promise é cumprida de imediato. reject(reason) rejeita a promise. Só conta a primeira chamada a qualquer uma das funções; as chamadas seguintes são ignoradas, mesmo que o resultado adotado ainda seja desconhecido.
Os handlers registados com .then() são executados de forma assíncrona. O exemplo apresenta primeiro sync e depois fulfilled: 42; a chamada a reject é ignorada. Disponibilize as funções de resolução apenas ao código que deve controlar o resultado.
Verifique a disponibilidade com typeof Promise.withResolvers === "function". A especificação, por si só, não confirma o suporte num determinado browser; o Node 24 no repositório também não o confirma.
Exemplos
const { promise, resolve, reject } = Promise.withResolvers();
promise.then(
value => console.log(`fulfilled: ${value}`),
reason => console.log(`rejected: ${reason}`)
);
resolve(42);
reject("ignored");
console.log("sync");Resultado
sync fulfilled: 42
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.