Promise.reject()
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2015.
El método Promise.reject(reason) retorna un objeto Promise que es rechazado por la razón específicada.
Pruébalo
function resolved(result) {
console.log("Resolved");
}
function rejected(result) {
console.error(result);
}
Promise.reject(new Error("fail")).then(resolved, rejected);
// Expected output: Error: fail
Sintaxis
Promise.reject(reason);
Parámetros
- reason
-
Razón por la cual esta {jsxref("Promise")}} fue rechazada.
Return value
Un objeto Promise que es rechazado por la razón específicada.
Descripción
La función estática Promise.reject retorna un objecto Promise que es rechazado. Para fines de depuración y captura selectiva de error, se suele pasar por el parámetro reason un instanceof Error.
Ejemplos
Usando el método estático Promise.reject()
js
Promise.reject(new Error("fail")).then(
function () {
// no entra en esta función
},
function (error) {
console.log(error); // Stacktrace
},
);
Especificaciones
| Especificación |
|---|
| ECMAScript® 2027 Language Specification # sec-promise.reject |