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

CKTIS / JavaScript

Promise — resultados de operações e funções resolve/reject

Uma Promise representa um resultado futuro ou o motivo de uma falha. Saiba como o executor é executado de forma síncrona, como resolve e reject determinam o resultado e como then e catch o tratam de forma assíncrona.

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

new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);

Promise representa o resultado de uma operação que poderá terminar mais tarde. O seu estado é pending, fulfilled ou rejected; os dois últimos são definitivos. Criar uma promessa não transfere, por si só, o trabalho para outra thread.

new Promise(executor) chama o executor de forma síncrona e fornece-lhe as funções resolve e reject. resolve(value) cumpre a promessa com um valor comum ou adota o resultado de uma promessa ou de um thenable, ou seja, um objeto com um método then invocável. reject(reason) rejeita a promessa; é preferível usar um Error como motivo. A primeira chamada a qualquer uma destas funções impede chamadas posteriores, mesmo que o resultado adotado continue pending. Por isso, resolver nem sempre significa cumprimento imediato.

O valor devolvido pelo executor é ignorado. Uma exceção síncrona lançada no seu interior rejeita a promessa, a menos que resolve ou reject já tenha sido chamado. Os handlers registados através de then são executados de forma assíncrona, depois de terminar a execução atual. then devolve uma nova promessa: um valor devolvido determina o seu resultado, enquanto uma exceção lançada a rejeita. catch trata as rejeições.

No exemplo, o executor escreve executor e o código síncrono escreve sync antes de result: 42. Chamar reject depois de resolve(21) não tem efeito. O exemplo requer um ambiente de execução com Promise e console; não pressupõe APIs Web adicionais nem uma versão específica do browser.

Exemplos

const promise = new Promise((resolve, reject) => {
  console.log("executor");
  resolve(21);
  reject(new Error("ignored"));
});

promise
  .then(value => value * 2)
  .then(value => console.log(`result: ${value}`))
  .catch(error => console.log(error.message));

console.log("sync");

Resultado

executor
sync
result: 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