Accueil › React › Le build et le découpage du paquet
Le build et le découpage du paquet
Mise en productionavance
Tout ce qui entre dans le paquet doit être téléchargé, analysé et exécuté avant que la page réponde. La taille n'est pas un détail d'esthétique.
Le découpage par route
import { lazy, Suspense } from "react";
const Statistiques = lazy(() => import("./pages/Statistiques"));
<Suspense fallback={<Squelette />}>
<Statistiques />
</Suspense>
L'import() crée un fichier séparé. La page de statistiques et sa
bibliothèque de graphiques ne partent plus chez les visiteurs qui ne l'ouvrent
jamais.
Ce qui ne découpe rien
// ❌ un fichier par composant ne change rien au paquet
import { Statistiques } from "./pages/Statistiques";
Un import statique finit toujours dans le même paquet, quel que soit le nombre
de fichiers sources. Seul import() coupe.
L'élagage et ses conditions
// ✅ l'outil sait ce qui est utilisé
import { formater } from "./outils";
// ❌ il garde tout : l'accès pourrait être dynamique
import * as outils from "./outils";
Mesurer avant de découper
npm run build # Vite affiche la taille de chaque fichier produit
dist/assets/index-a3f9.js 187.42 kB │ gzip: 59.11 kB
dist/assets/Statistiques-7c2.js 312.08 kB │ gzip: 98.40 kB
Un rapport visuel (rollup-plugin-visualizer) montre ce qu'il y a dedans —
et c'est là qu'on découvre la bibliothèque de dates de 300 Ko importée pour
formater une seule date.
Le cache
Les fichiers produits portent une empreinte de contenu : index-a3f9.js. On
peut donc les mettre en cache un an. Seul index.html ne doit jamais l'être
longuement : c'est lui qui référence les autres.
Les termes à connaître
- Paquet (bundle)
Le fichier JavaScript produit par la construction. Tout ce qu'il contient doit être téléchargé, analysé et exécuté avant que la page réponde.
- Découpage (code splitting)
Produire plusieurs fichiers au lieu d'un, pour ne charger que ce dont la page a besoin. Un import dynamique crée une coupure.
- Élagage (tree shaking)
L'outil retire le code exporté mais jamais importé. Il ne fonctionne qu'avec des modules ES et des imports nommés.
- Import dynamique
import()rend une promesse et crée un fichier séparé. C'est le seul mécanisme de découpage,React.lazyn'en est qu'un habillage.- Empreinte de contenu
Le code aléatoire dans le nom du fichier produit. Il permet un cache d'un an : un contenu différent donne un nom différent.
- Analyse du paquet
Un rapport visuel de ce que contient chaque fichier produit. C'est la seule façon de découvrir la bibliothèque de 300 Ko qu'on n'a pas vue arriver.
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.