Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Promise.prototype.catch — gérer les rejets

La méthode catch() ajoute un gestionnaire de rejet à une promesse. Elle permet de récupérer en renvoyant une valeur de succès ou de propager un échec et, avec la méthode then standard, renvoie une nouvelle promesse.

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.catch(onRejected)

Promise.prototype.catch appelle this.then(undefined, onRejected). Avec la méthode then standard, elle renvoie une nouvelle promesse sans modifier l’état de la promesse d’origine. Le gestionnaire onRejected reçoit la raison du rejet, qui n’est pas nécessairement un objet Error, et s’exécute de façon asynchrone, même si la promesse était déjà rejetée.

Renvoyer une valeur ordinaire depuis le gestionnaire réalise la nouvelle promesse avec cette valeur ; omettre return produit undefined. Renvoyer une promesse ou un objet doté d’une méthode then appelable fait adopter à la nouvelle promesse son résultat final. Lever une erreur rejette la nouvelle promesse. Pour propager un échec, utilisez throw au lieu de simplement l’afficher.

Si la promesse est réalisée, le gestionnaire est ignoré et la valeur est transmise. Si onRejected n’est pas une fonction, le rejet est également transmis. Un catch placé après then traite aussi les erreurs levées dans cette étape précédente, mais pas celles des étapes suivantes ni celles d’opérations asynchrones indépendantes qui n’ont pas été renvoyées.

Exemples

Promise.resolve(10)
  .then(() => {
    throw new Error("failed");
  })
  .catch((error) => {
    console.log(error.message);
    return 42;
  })
  .then((value) => {
    console.log(value);
  });
console.log("sync");

Résultat

sync
failed
42

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.

Sources