Accueil › React › Les composants serveur
Les composants serveur
Rendu serveur et Next.jsavance
Un composant serveur s'exécute uniquement sur le serveur. Son code n'est jamais envoyé au navigateur.
// app/clients/page.jsx — composant serveur par défaut (Next.js App Router)
import { db } from "@/lib/db";
export default async function Clients() {
const clients = await db.client.findMany(); // directement la base
return (
<ul>
{clients.map((c) => <li key={c.id}>{c.nom}</li>)}
</ul>
);
}
Pas de route d'API, pas de fetch, pas d'état de chargement. Et zéro
octet de JavaScript pour ce composant.
Ce qu'il ne peut pas faire
// ❌ dans un composant serveur
const [n, setN] = useState(0);
useEffect(…);
<button onClick={…}>
Il s'exécute une fois, puis disparaît. Rien ne porte un état, rien ne réagit à un clic.
La frontière
// Compteur.jsx
"use client"; // ← la frontière
import { useState } from "react";
export function Compteur() {
const [n, setN] = useState(0);
return <button onClick={() => setN(n + 1)}>{n}</button>;
}
Tout ce qu'un fichier client importe devient client. Une directive posée trop haut fait basculer tout un sous-arbre, sans qu'aucune erreur ne le signale.
La règle d'or
Descendre la frontière le plus bas possible. Le bouton est client ; la page qui le contient reste serveur.
Ce qui traverse
<Compteur depart={5} libelle="Clics" onEnvoyer={enregistrer} />
Nombres, chaînes, objets simples : oui. Une fonction ordinaire : non, elle n'est pas sérialisable. Seule exception, l'action serveur.
"use server";
export async function enregistrer(donnees) {
await db.clic.create({ data: donnees });
}
Les termes à connaître
- Composant serveur
Un composant qui s'exécute uniquement sur le serveur. Son code n'est jamais envoyé au navigateur, et il peut lire une base de données directement.
- Composant client
Un composant marqué « use client ». Il s'exécute aussi dans le navigateur, et c'est le seul qui a droit à l'état, aux effets et aux événements.
- Frontière
La directive « use client » en haut d'un fichier. Tout ce que ce fichier importe devient client à son tour.
- Sérialisation des props
Ce qui traverse la frontière doit pouvoir être sérialisé : nombres, chaînes, objets simples, et les fonctions serveur. Pas une classe, pas une fonction ordinaire.
- Action serveur
Une fonction marquée « use server », appelable depuis un composant client. C'est la seule fonction qui traverse la frontière.
- SSR
Un mécanisme distinct : rendre du HTML sur le serveur. Les composants serveur réduisent le JavaScript envoyé ; le SSR accélère le premier affichage. Les deux cohabitent.
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.