Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Promise.resolve — normalizar un valor como promesa

Promise.resolve(value) permite tratar un valor ordinario, una promesa o un thenable como una promesa. Puede devolver una promesa existente sin modificarla; resolved no significa que el resultado ya esté disponible ni que la operación vaya a tener éxito.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Promise.resolve(value)

Promise.resolve(value) es un método estático que normaliza un valor como promesa. Si se omite el argumento, se usa undefined. Cuando el método crea una promesa nueva, esta se cumple con el argumento si es un valor primitivo o si es un objeto cuya propiedad then se puede leer sin que se lance una excepción y contiene un valor no invocable. Si la lectura de then lanza una excepción, la promesa nueva se rechaza con esa excepción como motivo.

Si p es una promesa real, Promise.resolve(p) lee su propiedad constructor. Si la lectura devuelve Promise, el método devuelve exactamente p. Si el getter de constructor lanza una excepción, el método la propaga de forma síncrona antes de crear una promesa nueva, incluso si la evaluación del propio argumento p no da ningún error. El método crea una promesa nueva si el argumento no es una promesa real o si la lectura de su propiedad constructor devuelve un valor distinto de Promise. Se asimila un thenable, es decir, un objeto con un then invocable, y el resultado sigue su desenlace, incluso a través de otros thenables. Un rechazo sigue siendo un rechazo; resolved no significa fulfilled.

Las funciones de retorno pasadas a .then() se ejecutan de forma asíncrona, incluso si la promesa ya está cumplida. El método no captura los errores que se producen al evaluar su argumento: si fn() lanza una excepción en Promise.resolve(fn()), la llamada la lanza de forma síncrona. Para aplazar la llamada y convertir esa excepción en un rechazo, usa Promise.resolve().then(() => fn()).

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes