Accueil › Vue.js › Le cycle de vie en rendu serveur
Le cycle de vie en rendu serveur
Cycle de vie et effetsintermediaire
En rendu serveur, un composant est transformé une fois en chaîne de caractères. Il n'est jamais inséré dans un document, donc jamais monté, jamais mis à jour, jamais démonté.
Conséquence directe : onMounted et onUnmounted ne sont pas appelés sur le
serveur. Ni onBeforeMount, ni onUpdated, ni onBeforeUnmount. Ce qui
s'exécute sur le serveur, c'est le corps de setup, les computed lus pendant
le rendu, et onServerPrefetch.
<script setup>
import { ref, onMounted } from 'vue'
const theme = ref('clair') // exécuté sur le serveur ET sur le client
onMounted(() => { // exécuté dans le navigateur uniquement
theme.value = localStorage.getItem('theme') ?? 'clair'
})
</script>
Cette asymétrie est une garantie, pas une gêne. onMounted est le sas qui
sépare le code universel du code qui a besoin d'un navigateur : window,
document, localStorage, IntersectionObserver, toute bibliothèque qui
manipule le DOM.
L'autre face de la pièce est le désaccord d'hydratation. Le premier rendu
dans le navigateur doit produire exactement le même HTML que le serveur. Si
setup lit l'heure courante, un nombre aléatoire ou la largeur de la fenêtre,
les deux rendus divergent et Vue signale l'écart. La valeur variable doit être
écrite après le montage, pas pendant.
Les termes à connaître
- Rendu serveur
La production du HTML d'un composant sur le serveur, sans navigateur. Le client reçoit du balisage déjà rempli, puis Vue le reprend en main.
- Hydratation
L'étape pendant laquelle Vue, dans le navigateur, rattache ses écouteurs et sa réactivité au HTML reçu du serveur, sans le recréer.
- onServerPrefetch
Le seul crochet propre au serveur. Il permet d'attendre une promesse avant que le HTML ne soit produit.
- import.meta.env.SSR
Drapeau exposé par Vite, vrai pendant l'exécution serveur. Il permet d'isoler un bloc de code réservé au navigateur.
- Désaccord d'hydratation
Une différence entre le HTML produit par le serveur et celui que le client calcule au premier rendu. Vue le signale et reconstruit la partie concernée.
- ClientOnly
Un composant fourni par les cadres de rendu serveur, qui n'affiche son contenu qu'après l'hydratation.
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.