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éthodePromise.reject(raison) renvoie un objetPromise 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

Promise.reject(raison);

Paramètres

raison: La raison pour laquelle laPromise n'a pas été tenue.

Valeur de retour

Une promesse (Promise) qui est rompue avec la raison passée en argument.

La fonction statiquePromise.reject renvoie unePromise 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'argumentraison 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  },);