Formations — 1 037 leçons en français

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.

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.