Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes