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());
then: si tenuecatch: si rompuefinally: dans les deux cas, sans argument
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.
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.