Formations — 1 037 leçons en français

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.

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.