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

CKTIS / JavaScript

Promise.withResolvers(): una promesa con funciones de resolución accesibles

Promise.withResolvers() devuelve una promesa nueva y sus funciones asociadas resolve y reject. Permite separar la creación de la promesa de la entrega de su resultado, por ejemplo, al adaptar una interfaz basada en callbacks.

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

const { promise, resolve, reject } = Promise.withResolvers();

Promise.withResolvers() es un método estático de ECMAScript 2024, no una API web. No acepta argumentos y devuelve un objeto ordinario con las propiedades promise, resolve y reject. Con Promise.withResolvers(), la promesa queda inicialmente a la espera de un resultado; no se proporciona una función ejecutora como en new Promise(executor).

resolve(value) acepta un valor o adopta el resultado futuro de una promesa o un thenable. Por eso, llamar a resolve no siempre significa que la promesa se cumpla de inmediato. reject(reason) rechaza la promesa. Solo cuenta la primera llamada a cualquiera de estas funciones; las posteriores se ignoran, incluso mientras el resultado adoptado siga siendo desconocido.

Los manejadores registrados con .then() se ejecutan de forma asíncrona. El ejemplo muestra primero sync y después fulfilled: 42; la llamada a reject se ignora. Expón las funciones de resolución únicamente al código que deba controlar el resultado.

Comprueba la disponibilidad con typeof Promise.withResolvers === "function". La especificación por sí sola no demuestra que sea compatible con un navegador concreto; Node 24 en el repositorio tampoco lo demuestra.

Ejemplos

const { promise, resolve, reject } = Promise.withResolvers();

promise.then(
  value => console.log(`fulfilled: ${value}`),
  reason => console.log(`rejected: ${reason}`)
);

resolve(42);
reject("ignored");
console.log("sync");

Resultado

sync
fulfilled: 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