Promise.resolve()
O método Promise.resolve(value)
retorna um objeto Promise
que é resolvido com o valor passado. Se o valor for thenable (ex: tiver um método then
), a promise retornada irá "seguir" esse thenable, adotando seu estado final; se o valor for uma promise, o objeto será o resultado da chamada Promise.resolve; do contrário a promise será realizada com o valor.
Sintaxe
Promise.resolve(value); Promise.resolve(promise); Promise.resolve(thenable);
Parametros
- value
-
Argumento a ser resolvido pela
Promise
. Pode também ser umaPromise
ou um thenable a resolver.
Valor retornado
Descrição
A função estática Promise.resolve
retorna uma Promise
de que será resolvida.
Examples
Usando o método estático Promise.resolve
Promise.resolve("Success").then(function(value) {
console.log(value); // "Success"
}, function(value) {
// not called
});
Resolvendo um array
var p = Promise.resolve([1,2,3]);
p.then(function(v) {
console.log(v[0]); // 1
});
Resolvendo outra Promise
var original = Promise.resolve(true);
var cast = Promise.resolve(original);
cast.then(function(v) {
console.log(v); // true
});
A ordem invertida dos logs acontece devido ao fato de que os handlers são chamados assincronamente. Veja como o then
funciona aqui.
Resolvendo thenables e disparando Errors
// Resolving a thenable object
var p1 = Promise.resolve({
then: function(onFulfill, onReject) { onFulfill("fulfilled!"); }
});
console.log(p1 instanceof Promise) // true, object casted to a Promise
p1.then(function(v) {
console.log(v); // "fulfilled!"
}, function(e) {
// not called
});
// Thenable throws before callback
// Promise rejects
var thenable = { then: function(resolve) {
throw new TypeError("Throwing");
resolve("Resolving");
}};
var p2 = Promise.resolve(thenable);
p2.then(function(v) {
// not called
}, function(e) {
console.log(e); // TypeError: Throwing
});
// Thenable throws after callback
// Promise resolves
var thenable = { then: function(resolve) {
resolve("Resolving");
throw new TypeError("Throwing");
}};
var p3 = Promise.resolve(thenable);
p3.then(function(v) {
console.log(v); // "Resolving"
}, function(e) {
// not called
});
Especificações
Especificação | Status | Comentário |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Promise.resolve' in that specification. |
Padrão | Definição inicial no padrão ECMA. |
ECMAScript (ECMA-262) The definition of 'Promise.resolve' in that specification. |
Padrão em tempo real |
Compatibilidade com navegadores
BCD tables only load in the browser