Promise.reject()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode Promise.reject(raison) renvoie un objet Promise qui est rejeté (la promesse n'est pas tenue) à cause d'une raison donnée.
Exemple interactif
function resolved(result) {
console.log("Resolved");
}
function rejected(result) {
console.error(result);
}
Promise.reject(new Error("fail")).then(resolved, rejected);
// Expected output: Error: fail
Syntaxe
js
Promise.reject(raison);
Paramètres
raison-
La raison pour laquelle la
Promisen'a pas été tenue.
Valeur de retour
Une promesse (Promise) qui est rompue avec la raison passée en argument.
Description
La fonction statique Promise.reject renvoie une Promise qui est rejetée. Pour faciliter le débogage (comprendre plus rapidement le problème et sélectionner une erreur précise), il peut être utile que l'argument raison soit une instance d'Error.
Exemples
js
Promise.reject(new Error("échec")).then(
function () {
// n'est pas appelée
},
function (erreur) {
console.log(erreur); // Analyse de la pile d'appels
},
);
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-promise.reject |
Compatibilité des navigateurs
Chargement…