Accueil › Vue.js › Où placer les appels réseau
Où placer les appels réseau
Communiquer avec une APIintermediaire
Un appel réseau se place là où son cycle de vie est maîtrisé : on sait quand il part, quand il est annulé, et qui lit son résultat. Dans une application Vue 3, l'emplacement par défaut est un composable.
// composables/useArticle.ts
import { ref, watch, toValue, type MaybeRefOrGetter } from 'vue'
export function useArticle(id: MaybeRefOrGetter<string>) {
const article = ref<Article | null>(null)
const etat = ref<'inactif' | 'chargement' | 'succes' | 'erreur'>('inactif')
watch(() => toValue(id), async (valeur, _a, onCleanup) => {
const controleur = new AbortController()
onCleanup(() => controleur.abort())
etat.value = 'chargement'
try {
article.value = await lireArticle(valeur, controleur.signal)
etat.value = 'succes'
} catch (e) {
if ((e as Error).name !== 'AbortError') etat.value = 'erreur'
}
}, { immediate: true })
return { article, etat }
}
Le composant devient court et ne connaît aucune URL. Le composable, lui,
réagit au changement de paramètre, annule la requête précédente et s'arrête au
démontage parce que son watch est lié au composant qui l'appelle.
Trois autres emplacements existent, chacun pour une raison précise : un
store pour une donnée partagée entre écrans, une garde de route pour
ce qui conditionne l'accès, et jamais un computed.
Les termes à connaître
- Composable
Une fonction qui regroupe un état réactif et la logique qui l'accompagne. C'est l'emplacement par défaut d'un appel réseau dans une application Vue 3.
- Couche d'accès
Un module de fonctions sans réactivité qui connaît les URL, les en-têtes et le format des réponses. Le composable l'appelle, le composant ne la voit pas.
- Garde de route
Une fonction exécutée par Vue Router avant d'activer une route. Elle peut attendre une promesse, ce qui retarde l'affichage jusqu'à la réponse.
- Store Pinia
Un état partagé entre composants. Il héberge utilement les données consultées depuis plusieurs écrans, moins utilement celles d'un seul écran.
- Effet de bord
Une action qui modifie quelque chose hors du calcul en cours : écrire une variable, lancer une requête, journaliser. Un
computedn'en contient jamais.- Clé de composant
L'attribut
keyposé sur<RouterView>ou un composant. En changer force la destruction et la recréation, donc un nouveau montage.
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.