Accueil › JavaScript › async et await
async et await
async/await et fetchintermediaire
async/await écrit l'asynchrone comme du synchrone.
// avec des promesses
function charger() {
return fetch("/api/clients")
.then((r) => r.json())
.then((d) => d.clients);
}
// avec async/await
async function charger() {
const reponse = await fetch("/api/clients");
const donnees = await reponse.json();
return donnees.clients;
}
Même mécanique, même ordre d'exécution. Seule l'écriture change — et elle se lit de haut en bas.
Deux règles
async garantit une promesse en retour.
async function nombre() { return 42; }
nombre(); // Promise tenue avec 42, PAS 42
await nombre(); // 42
await n'est permis que dans une fonction async — ou au sommet d'un
module ES.
function charger() {
const d = await fetch("/api"); // ❌ SyntaxError
}
Ce qui précède le premier await est synchrone
async function f() {
console.log("A"); // tout de suite
await null;
console.log("B"); // microtâche
}
f();
console.log("C");
// A, C, B
La fonction s'exécute normalement jusqu'au premier await, puis rend la
main. Elle reprendra quand la promesse sera réglée.
await n'attend pas forcément une promesse
await 42; // valide : équivaut à await Promise.resolve(42)
Utile quand une fonction peut rendre une valeur ou une promesse selon le cas :
await traite les deux.
Les termes à connaître
- async
Un mot-clé devant une fonction. Il garantit qu'elle rend toujours une promesse, même si son corps retourne une valeur ordinaire.
- await
Suspend la fonction jusqu'à ce que la promesse soit réglée, et rend sa valeur. N'est permis que dans une fonction
asyncou au sommet d'un module.- Suspension
L'arrêt d'une fonction
asyncau niveau d'unawait. Le reste du programme continue : rien n'est bloqué, seule cette fonction attend.- Top-level await
L'usage d'
awaitdirectement dans un module, hors de toute fonction. Permis dans les modules ES, pas dans un script classique.- Valeur enveloppée
Le fait qu'une fonction
asyncqui retourne 42 rende en réalité une promesse tenue avec 42. L'appeler sansawaitdonne la promesse, pas le nombre.
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.