Formations — 1 037 leçons en français

Accueil › Vue.js › Annuler une requête devenue inutile

Annuler une requête devenue inutile

Communiquer avec une APIintermediaire

Quand une recherche se relance à chaque frappe, les réponses ne reviennent pas dans l'ordre des demandes. Une requête lente partie en premier peut aboutir après une requête rapide partie ensuite, et écraser le résultat affiché par un résultat périmé. Le symptôme est connu : la liste affiche les résultats d'un terme qu'on a fini d'effacer.

Deux protections se combinent. La première annule la requête devenue inutile.

let controleur: AbortController | null = null

async function chercher(terme: string) {
  controleur?.abort()
  controleur = new AbortController()
  try {
    const r = await fetch(`/api/recherche?q=${terme}`, { signal: controleur.signal })
    resultats.value = await r.json()
  } catch (e) {
    if (e instanceof DOMException && e.name === 'AbortError') return
    erreur.value = 'Recherche impossible'
  }
}

La seconde ignore toute réponse qui n'est plus la plus récente. Dans un composant, watch fournit la fenêtre de nettoyage.

watch(terme, (valeur, _ancienne, onCleanup) => {
  const controleur = new AbortController()
  onCleanup(() => controleur.abort())
  chercher(valeur, controleur.signal)
})

onCleanup s'exécute avant la prochaine exécution du rappel et à l'arrêt de l'observateur. L'annulation est donc couverte au changement de valeur comme au démontage, sans ligne supplémentaire.

Les termes à connaître

AbortController

Un objet du navigateur qui expose un signal. Appeler abort() interrompt la requête fetch à laquelle ce signal a été passé.

AbortSignal

Le jeton transmis à fetch via l'option signal. Quand il est déclenché, la promesse est rejetée avec une erreur nommée AbortError.

Réponse obsolète

Une réponse qui arrive après une demande plus récente. Si on la laisse écrire, elle remplace un résultat plus à jour par un ancien.

Compteur de version

Un entier incrémenté à chaque nouvelle demande. Une réponse n'écrit que si son numéro correspond encore au dernier émis.

onCleanup

Le troisième argument d'un rappel de watch et l'argument de watchEffect. La fonction enregistrée s'exécute avant la prochaine exécution et à l'arrêt.

Anti-rebond

Le fait de retarder le départ d'une requête jusqu'à ce que la saisie se calme. Il réduit le nombre d'appels, mais ne supprime pas le besoin d'annuler.

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.