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
fetchne rejette pas sur un 404 ni un 500.- AbortController
L'objet qui permet d'annuler une requête en vol. Son
signalse passe àfetch, etabort()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.
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.