CKTIS / JavaScript
Promise.reject — créer une promesse rejetée
Promise.reject(reason) crée une nouvelle promesse rejetée avec la raison fournie. Les gestionnaires de rejet s’exécutent de manière asynchrone, même si la promesse renvoyée est déjà rejetée au moment où elle est renvoyée.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.reject(reason)Promise.reject(reason) est une méthode statique du constructeur Promise. Elle renvoie une nouvelle promesse à l’état rejeté, avec reason comme motif de rejet. Ce motif peut être n’importe quelle valeur ; si l’argument est omis, undefined est utilisé. Pour les erreurs, préférez un objet Error.
La méthode n’adopte pas l’état d’une promesse fournie ni celui d’un objet doté d’une méthode then (un thenable). Cet argument devient lui-même le motif de rejet. Contrairement à Promise.resolve, Promise.reject ne renvoie pas telle quelle une promesse fournie.
Un appel ordinaire à Promise.reject(reason) n’est pas un throw synchrone : un try...catch qui l’entoure n’interceptera pas le rejet lui-même. Utilisez .catch(...) ou un try...catch autour de await. Les gestionnaires de promesse ne s’exécutent qu’une fois le code synchrone en cours terminé. Gérez les rejets ; la réaction à un rejet non géré dépend de l’environnement hôte.
Dans l’exemple, sync s’affiche avant l’exécution du gestionnaire de rejet, et true confirme que le motif conserve son identité. Appelez la méthode sous la forme Promise.reject(...) : son this doit être un constructeur compatible avec les conventions du constructeur Promise. Un appel détaché sans le bon receveur peut donc déclencher un TypeError.
Exemples
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");Résultat
sync true Invalid input
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.