Formations — 1 037 leçons en français

Accueil › JavaScript › Ce qu'est une promesse

Ce qu'est une promesse

Les promessesintermediaire

Une promesse est un objet qui représente une valeur pas encore là.

const reponse = fetch("/api/clients");
console.log(reponse);     // Promise { <pending> } — pas les clients

Trois états, et un seul passage

en attente  ──→  tenue   (une valeur)
            └─→  rompue  (une raison)

Une promesse se règle une seule fois, définitivement. C'est sa garantie centrale, et c'est précisément ce qu'un rappel ne garantit pas.

Lire la valeur

fetch("/api/clients")
  .then((reponse) => console.log("arrivé", reponse.status))
  .catch((erreur) => console.log("échoué", erreur))
  .finally(() => masquerChargement());

La suite est toujours asynchrone

Promise.resolve(1).then((v) => console.log(v));
console.log("fin");
// affiche « fin », puis 1

Même sur une promesse déjà tenue, la suite est une microtâche : elle attend que la pile soit vide. Le langage garantit ainsi qu'une interface ne sera jamais à moitié synchrone — l'inverse du défaut vu au chapitre précédent.

En fabriquer une

const attendre = (ms) => new Promise((resoudre) => setTimeout(resoudre, ms));

await attendre(500);

new Promise ne sert qu'à emballer quelque chose qui n'est pas déjà une promesse. Partout ailleurs, on enchaîne celles qui existent.

Les termes à connaître

Promesse

Un objet qui représente une valeur pas encore disponible. Elle existe tout de suite ; sa valeur arrive plus tard, ou jamais.

En attente

L'état initial : le résultat n'est pas connu. Une promesse en attente ne bloque rien ; elle se contente d'exister.

Tenue

L'état d'une promesse qui a obtenu sa valeur. Définitif : une promesse tenue ne peut plus changer d'état.

Rompue

L'état d'une promesse qui a échoué, avec une raison — presque toujours un objet Error. Définitif aussi.

Réglée

Tenue ou rompue, c'est-à-dire plus en attente. Une promesse ne se règle qu'une fois : c'est sa garantie centrale.

then

Enregistre la suite à exécuter quand la promesse est tenue. Rend une nouvelle promesse, ce qui permet le chaînage.

catch

Enregistre la suite en cas de rejet. Équivaut à then(undefined, fn), en plus lisible.

finally

Exécuté dans les deux cas, sans recevoir ni valeur ni raison. Pour ranger : masquer un indicateur de chargement, fermer une connexion.

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.