Formations — 1 037 leçons en français

Accueil › JavaScript › Appeler une API pour de vrai

Appeler une API pour de vrai

async/await et fetchintermediaire

Lire

async function lireJson(url) {
  const reponse = await fetch(url);
  if (!reponse.ok) throw new Error(`HTTP ${reponse.status} sur ${url}`);
  return reponse.json();
}

Trois lignes, et les trois comptent. Deux await : fetch rend la réponse dès les en-têtes, le corps se lit ensuite. Le test ok : sans lui, un 500 devient un undefined quinze lignes plus loin.

Envoyer

const reponse = await fetch("/api/clients", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ nom: "Anne" }),
});

Pour un fichier, on passe le FormData tel quel et sans Content-Type :

await fetch("/api/import", { method: "POST", body: new FormData(formulaire) });

Le navigateur compose l'en-tête avec la frontière multipartie. L'écrire à la main casse la requête.

Annuler

let controleur;

async function chercher(texte) {
  controleur?.abort();                    // annule la précédente
  controleur = new AbortController();

  try {
    const r = await fetch(`/api?q=${encodeURIComponent(texte)}`, {
      signal: controleur.signal,
    });
    afficher(await r.json());
  } catch (erreur) {
    if (erreur.name === "AbortError") return;    // annulation : rien à dire
    afficherErreur(erreur);
  }
}

C'est la façon d'éviter qu'une réponse ancienne écrase une récente. Un anti-rebond réduit le nombre de requêtes ; seule l'annulation garantit qu'une seule réponse sera traitée.

encodeURIComponent, toujours

`/api?q=${encodeURIComponent(texte)}`

Une recherche contenant &, = ou # casserait l'URL sans cela.

Les termes à connaître

fetch

La fonction intégrée qui fait une requête HTTP. Elle rend une promesse de réponse, pas de contenu — lire le corps demande un second await.

reponse.ok

Vrai pour un statut de 200 à 299. Le seul test qui dit si la requête a abouti, puisque fetch ne rejette pas sur un 404 ni un 500.

AbortController

L'objet qui permet d'annuler une requête en vol. Son signal se passe à fetch, et abort() l'interrompt.

AbortError

L'erreur levée par une requête annulée. Ce n'est pas une panne : elle ne doit afficher aucun message.

Condition de course

Deux requêtes en vol dont les réponses arrivent dans le désordre. La plus ancienne écrase la plus récente, et l'écran affiche un résultat périmé.

Content-Type

L'en-tête qui annonce le format du corps envoyé. Obligatoire pour du JSON ; à ne jamais écrire pour un FormData, que le navigateur compose lui-même.

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.