Formations — 1 037 leçons en français

Accueil › JavaScript › Enchaîner des promesses

Enchaîner des promesses

Les promessesintermediaire

Chaque then rend une nouvelle promesse. On enchaîne donc :

fetch("/api/clients")
  .then((reponse) => reponse.json())
  .then((clients) => clients.filter((c) => c.actif))
  .then((actifs) => afficher(actifs))
  .catch((erreur) => afficherErreur(erreur));

Quatre étapes, un seul niveau d'indentation, une seule gestion d'erreur. Comparez à l'imbrication des rappels du chapitre précédent.

Retourner une promesse l'aplatit

.then((reponse) => reponse.json())     // rend une promesse
.then((donnees) => …)                   // reçoit les DONNÉES, pas la promesse

C'est la mécanique essentielle : si un then retourne une promesse, le suivant attend sa résolution. Sans ça, il faudrait imbriquer — et on serait revenu au point de départ.

Le return n'est pas optionnel

// ❌
.then((v) => { v + 1; })
.then((v) => console.log(v))      // undefined

// ✅
.then((v) => { return v + 1; })
.then((v) => console.log(v))      // 2

Même piège que map et reduce, même symptôme : un undefined qui apparaît deux étapes plus loin, loin de sa cause.

Un rejet saute tout jusqu'au catch

Promise.reject(new Error("x"))
  .then(() => console.log("A"))     // sauté
  .then(() => console.log("B"))     // sauté
  .catch((e) => console.log("C"));  // exécuté

C'est ce qui permet une seule gestion d'erreur pour dix étapes.

Les termes à connaître

Chaînage

Enchaîner des then parce que chacun rend une nouvelle promesse. C'est ce qui remplace l'imbrication des rappels par une suite plate.

Aplatissement

Le fait qu'un then qui retourne une promesse attende sa résolution avant de passer la valeur au suivant. Sans ça, on recevrait une promesse au lieu de la valeur.

Propagation du rejet

Un rejet saute tous les then suivants jusqu'au premier catch. C'est ce qui permet une seule gestion d'erreur pour toute une chaîne.

Reprise après erreur

Un catch placé au milieu d'une chaîne la fait repartir : son retour devient la valeur du then suivant.

Chaîne brisée

Un then dont on oublie le return : le suivant reçoit undefined au lieu de la valeur attendue, sans qu'aucune erreur ne soit levée.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.