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.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
Promise.reject(raison);
Paramètres
raison
- La raison pour laquelle la
Promise
n'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
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
Spécification | État | Commentaires |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Promise.reject' dans cette spécification. |
Standard | Définition initiale au sein d'un standard ECMA. |
ECMAScript (ECMA-262) La définition de 'Promise.reject' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Pour contribuer à ces données de compatibilité, vous pouvez envoyer une poule requête sur : https://github.com/mdn/browser-compat-data.