Formations — 1 037 leçons en français

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 async ou au sommet d'un module.

Suspension

L'arrêt d'une fonction async au niveau d'un await. Le reste du programme continue : rien n'est bloqué, seule cette fonction attend.

Top-level await

L'usage d'await directement 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 async qui retourne 42 rende en réalité une promesse tenue avec 42. L'appeler sans await donne la promesse, pas le nombre.

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.