Server vs Client Components
IntermédiaireCe qui s’exécute sur le serveur et ce qui s’exécute dans le navigateur : un Server Component qui charge des données, un bouton "use client", le HTML, le payload RSC et l’hydratation.S'appuie sur What happens when state changes, What happens when you type a URL
Vide
Spacelecture ou pause←→étape précédente ou suivanteRrevenir au début
Explication
Lecture : 4 min
Sur cette page
Que sont les Server et Client Components dans Next.js ?
Avec l'App Router, chaque composant est un Server Component sauf indication contraire. Un Server
Component ne s'exécute que sur le serveur : il peut être async, lire une base de données ou un
fichier, utiliser des secrets, et son code n'est jamais envoyé au navigateur. Ce qu'il envoie, c'est
son résultat.
Un Client Component est un composant qui a besoin du navigateur : un état (useState), des
effets, des gestionnaires d'événements comme onClick, ou des API du navigateur. On marque son
fichier avec 'use client' tout en haut. Les Client Components sont aussi rendus en HTML sur le
serveur au premier chargement : « client » ne veut donc pas dire « uniquement dans le navigateur »,
mais son code est aussi envoyé au navigateur, pour pouvoir s'y exécuter.
Qu'est-ce qui s'exécute où au chargement d'une page ?
- Sur le serveur, React rend les Server Components et place leur résultat dans le payload RSC : le rendu, un emplacement pour chaque Client Component, les props qui lui sont passées, et une référence à son fichier JavaScript. Avec les Client Components, ce payload sert à pré-rendre le HTML.
- Dans le navigateur, le HTML affiche la page tout de suite, avant toute exécution de JavaScript.
- Le navigateur télécharge le JavaScript des seuls Client Components et les hydrate : React les exécute de nouveau, les fait correspondre au HTML déjà affiché et attache leurs gestionnaires d'événements.
- Ensuite, les interactions dans un Client Component, comme un clic sur le bouton, se passent dans le navigateur. Aucune requête au serveur n'est nécessaire, sauf si votre code en fait une.
'use client' marque une . Tout ce que ce fichier importe, et chaque composant qu'il
rend directement, entre dans le bundle client. Les composants au-dessus de la frontière restent sur
le serveur.
Quelles erreurs fait-on souvent avec les Server et Client Components ?
Mini-exemple
Comments reste un Server Component même s'il est affiché dans le Collapsible interactif : la
page le rend sur le serveur et transmet le résultat en children.
// app/page.tsx: a Server Componentexport default function Page() { return ( <Collapsible> <Comments /> </Collapsible> );}// app/collapsible.tsx'use client'; export function Collapsible({ children }: { children: React.ReactNode }) { const [open, setOpen] = useState(false); return ( <section> <button onClick={() => setOpen(!open)}>Comments</button> {open && children} </section> );}Test rapide
Lequel de ces éléments un Server Component peut-il passer en prop à un Client Component ?
Pour aller plus loin
Toutes les étapes en texte
- Étape 1:
Vous ouvrez la page. Le navigateur envoie une requête pour / au serveur Next.js.
- Étape 2:
Sur le serveur, React exécute Page, un Server Component. C’est une fonction asynchrone : elle peut attendre des données directement.
Lignes 3–4
- Étape 3:
getPostlit l’article directement dans la base de données. Le navigateur ne lui parle jamais, et ne reçoit jamais ce code.Ligne 4
- Étape 4:
Page renvoie un article qui contient un LikeButton. LikeButton est un Client Component : il est rendu en HTML ici aussi, mais son code ira aussi au navigateur.
Lignes 5–10
- Étape 5:
La réponse contient le HTML et le payload RSC : le résultat de Page, un emplacement pour LikeButton, ses props et l’adresse de son code.
Lignes 6–8
- Étape 6:
Le navigateur affiche le HTML aussitôt : le titre et
♥ 3sont à l’écran, mais le bouton ne réagit pas encore. - Étape 7:
Il télécharge ensuite du JavaScript, mais seulement pour les Client Components : le code de LikeButton, plus React. Le code de Page reste sur le serveur.
Lignes 13–15
- Étape 8:
Hydratation : React exécute LikeButton dans le navigateur avec
likes = 3venu du payload, et attache son gestionnaire de clic au bouton déjà affiché.Lignes 16–18
- Étape 9:
Vous cliquez.
setCounts’exécute dans le navigateur et le bouton affiche♥ 4, sans aucune requête au serveur.Ligne 19
- Étape 10:
Les Server Components ne s’exécutent que sur le serveur et envoient leur résultat. Les Client Components envoient aussi leur code, pour s’exécuter dans le navigateur et vous répondre.