CKTIS / JavaScript
Promise — resultados de operaciones y funciones resolve/reject
Un Promise representa un resultado futuro o el motivo de un fallo. Aprende cómo se ejecuta su executor de forma síncrona, cómo resolve y reject determinan el resultado y cómo then y catch lo gestionan de forma asíncrona.
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
new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);Promise representa el resultado de una operación que quizá termine más adelante. Su estado es pending, fulfilled o rejected; los dos últimos son definitivos. Crear una promesa no traslada por sí mismo el trabajo a otro hilo.
new Promise(executor) llama al executor de forma síncrona y le proporciona las funciones resolve y reject. resolve(value) cumple la promesa con un valor ordinario o adopta el resultado de una promesa o un thenable, es decir, un objeto con un método then invocable. reject(reason) rechaza la promesa; es preferible usar un Error como motivo. La primera llamada a cualquiera de estas funciones impide las llamadas posteriores, incluso si el resultado adoptado sigue en estado pending. Por tanto, resolver no siempre significa que el cumplimiento sea inmediato.
Se ignora el valor que devuelve el executor. Una excepción síncrona lanzada dentro de él rechaza la promesa, salvo que ya se haya llamado a resolve o reject. Los controladores registrados mediante then se ejecutan de forma asíncrona, cuando termina la ejecución actual. then devuelve una promesa nueva: el valor devuelto determina su resultado, mientras que una excepción lanzada la rechaza. catch gestiona los rechazos.
En el ejemplo, el executor muestra executor y el código síncrono muestra sync antes de result: 42. Llamar a reject después de resolve(21) no tiene efecto. El ejemplo requiere un entorno de ejecución con Promise y console; no presupone API web adicionales ni una versión concreta del navegador.
Ejemplos
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
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.