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.