Formations — 1 037 leçons en français

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 useAsyncData autour 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.

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.