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

CKTIS / JavaScript

Promise.reject — crear una promesa rechazada

Promise.reject(reason) crea una nueva promesa rechazada con el motivo indicado. Los controladores de rechazo se ejecutan de forma asíncrona, aunque la promesa devuelta ya está rechazada cuando se devuelve.

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.reject(reason)

Promise.reject(reason) es un método estático del constructor Promise. Devuelve una nueva promesa en estado rechazado, con reason como motivo del rechazo. El motivo puede ser cualquier valor; si se omite el argumento, se usa undefined. Para los errores, es preferible usar un objeto Error.

El método no adopta el estado de una promesa proporcionada ni el de un objeto con un método then (un thenable). Ese argumento se convierte en el propio motivo del rechazo. A diferencia de Promise.resolve, Promise.reject no devuelve sin cambios una promesa proporcionada.

Una llamada normal a Promise.reject(reason) no es un throw síncrono: un try...catch que la rodee no capturará el rechazo en sí. Usa .catch(...) o un try...catch alrededor de await. Los controladores de promesas se ejecutan solo después de que termina el código síncrono actual. Gestiona los rechazos; la respuesta ante un rechazo no gestionado depende del entorno anfitrión.

En el ejemplo, sync aparece antes de que se ejecute el controlador de rechazo, y true confirma que el motivo conserva su identidad. Llama al método como Promise.reject(...): su this debe ser un constructor compatible con las convenciones del constructor Promise, por lo que una llamada separada sin el receptor adecuado puede lanzar un TypeError.

Ejemplos

const reason = new Error("Invalid input");
const rejected = Promise.reject(reason);

rejected.catch((error) => {
  console.log(error === reason);
  console.log(error.message);
});

console.log("sync");

Resultado

sync
true
Invalid input

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