Accueil › Vue.js › useAsyncData, la clé et le référencement
useAsyncData, la clé et le référencement
Nuxt et le rendu serveuravance
useAsyncData répond à une question propre au rendu serveur : comment ne pas
charger deux fois la même donnée, une fois sur le serveur et une fois pendant
l'hydratation.
<script setup>
const route = useRoute()
const { data, error, status, refresh } = await useAsyncData(
() => `produit-${route.params.id}`,
() => $fetch(`/api/produits/${route.params.id}`),
)
</script>
Sur le serveur, la fonction de chargement s'exécute et son résultat est
sérialisé dans le payload sous la clé donnée. Dans le navigateur, le même
appel retrouve cette entrée et n'exécute rien. C'est toute la différence avec
un $fetch écrit seul dans la mise en place, qui s'exécute des deux côtés et
fait donc le travail deux fois.
La clé porte cette mécanique. Elle nomme l'entrée du payload, elle dédoublonne
les appels — deux composants de même clé partagent un seul chargement — et elle
décide de ce qui est réutilisé. D'où la règle : tout ce qui fait varier le
résultat doit apparaître dans la clé. Une clé 'produit' fixe pour toutes
les fiches donne une page qui affiche le produit précédent.
useFetch(url) est l'enveloppe courante : elle calcule une clé à partir de
l'URL, des options et de l'emplacement de l'appel, ce qui évite d'en inventer
une.
Les termes à connaître
- useAsyncData
Composable de Nuxt qui exécute une fonction de chargement sur le serveur, place son résultat dans le payload, et le restitue au client sans le réexécuter.
- Clé de données
La chaîne qui identifie un chargement. Elle nomme l'entrée du payload et sert à dédoublonner les appels : deux appels de même clé partagent le même résultat.
- useFetch
Enveloppe de
useAsyncDataautour de$fetch. Elle calcule une clé automatiquement à partir de l'URL, des options et de l'emplacement de l'appel.- $fetch
Le client HTTP de Nuxt. Appelé seul dans la mise en place, il ne passe par aucun payload : la requête est refaite dans le navigateur.
- useSeoMeta
Composable qui déclare les balises
<meta>courantes sous forme de propriétés typées. Les valeurs dynamiques se passent en fonctions pour rester réactives.- useHead
Composable général pour agir sur l'en-tête du document — titre, modèle de titre, liens, scripts, balises quelconques.
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.