Promise.resolve()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
Specification |
---|
ECMAScript Language Specification # sec-promise.resolve |
Compatibilidade com navegadores
BCD tables only load in the browser