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. Appelerabort()interrompt la requêtefetchà laquelle ce signal a été passé.- AbortSignal
Le jeton transmis à
fetchvia l'optionsignal. Quand il est déclenché, la promesse est rejetée avec une erreur nomméeAbortError.- 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
watchet l'argument dewatchEffect. 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.
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.