CKTIS / JavaScript
Promise.resolve — normalizar um valor para uma promessa
Promise.resolve(value) permite tratar um valor comum, uma promessa ou um thenable como uma promessa. Pode devolver uma promessa existente sem a alterar; resolved não significa que o resultado já esteja disponível nem que a operação seja bem-sucedida.
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
Promise.resolve(value)Promise.resolve(value) é um método estático que normaliza um valor para uma promessa. Se o argumento for omitido, é usado undefined. Quando o método cria uma nova promessa, esta é cumprida com o argumento se este for um valor primitivo ou um objeto cuja propriedade then possa ser lida sem lançar uma exceção e devolva um valor não invocável. Se a leitura de then lançar uma exceção, a nova promessa é rejeitada com essa exceção como motivo.
Se p for uma promessa genuína, Promise.resolve(p) lê a sua propriedade constructor. Se a leitura devolver Promise, o método devolve exatamente p. Se o getter de constructor lançar uma exceção, o método propaga-a de forma síncrona antes de criar uma nova promessa, mesmo que a avaliação do próprio argumento p não produza erros. O método cria uma nova promessa se o argumento não for uma promessa genuína ou se a leitura da sua propriedade constructor devolver um valor diferente de Promise. Um thenable, isto é, um objeto com um then invocável, é assimilado e o resultado segue o seu desfecho, mesmo através de outros thenables. Uma rejeição continua a ser uma rejeição; resolved não significa fulfilled.
As funções de callback passadas a .then() são executadas de forma assíncrona, mesmo quando a promessa já está cumprida. O método não captura erros resultantes da avaliação do argumento: se fn() lançar uma exceção em Promise.resolve(fn()), a chamada lança-a de forma síncrona. Para adiar a chamada e transformar essa exceção numa rejeição, usa Promise.resolve().then(() => fn()).
Exemplos
const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);
const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");Resultado
true sync 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.