Aller au contenu
YouTurkey Tech
Tous les sujets Next.js

Server vs Client Components

Intermédiaire

Ce 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

Messages

Vide

0/10Appuyez sur Lecture, ou avancez pas à pas avec les flèches, pour commencer.
Étape 0 sur 10

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 ?

  1. 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.
  2. Dans le navigateur, le HTML affiche la page tout de suite, avant toute exécution de JavaScript.
  3. 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.
  4. 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
  1. Étape 1:

    Vous ouvrez la page. Le navigateur envoie une requête pour / au serveur Next.js.

  2. É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

  3. Étape 3:

    getPost lit l’article directement dans la base de données. Le navigateur ne lui parle jamais, et ne reçoit jamais ce code.

    Ligne 4

  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

  5. É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

  6. Étape 6:

    Le navigateur affiche le HTML aussitôt : le titre et ♥ 3 sont à l’écran, mais le bouton ne réagit pas encore.

  7. É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

  8. Étape 8:

    Hydratation : React exécute LikeButton dans le navigateur avec likes = 3 venu du payload, et attache son gestionnaire de clic au bouton déjà affiché.

    Lignes 16–18

  9. Étape 9:

    Vous cliquez. setCount s’exécute dans le navigateur et le bouton affiche ♥ 4, sans aucune requête au serveur.

    Ligne 19

  10. É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.