Meilleures pratiques React de Vercel
Guide complet d'optimisation des performances pour les applications React et Next.js, maintenu par Vercel. Contient 45 règles réparties en 8 catégories, priorisées par impact pour guider le refactoring automatisé et la génération de code.
Quand appliquer
Consultez ces directives lorsque vous :
- Écrivez de nouveaux composants React ou pages Next.js
- Implémentez la récupération de données (côté client ou serveur)
- Revoyez du code pour des problèmes de performance
- Refactorisez du code React/Next.js existant
- Optimisez la taille du bundle ou les temps de chargement
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe |
|---|---|---|---|
| 1 | Élimination des cascades | CRITIQUE | async- |
| 2 | Optimisation de la taille du bundle | CRITIQUE | bundle- |
| 3 | Performances côté serveur | HAUT | server- |
| 4 | Récupération de données côté client | MOYEN-HAUT | client- |
| 5 | Optimisation des re-rendus | MOYEN | rerender- |
| 6 | Performances de rendu | MOYEN | rendering- |
| 7 | Performances JavaScript | FAIBLE-MOYEN | js- |
| 8 | Schémas avancés | FAIBLE | advanced- |
Référence rapide
1. Élimination des cascades (CRITIQUE)
async-defer-await- Déplacer await dans les branches où il est réellement utiliséasync-parallel- Utiliser Promise.all() pour les opérations indépendantesasync-dependencies- Utiliser better-all pour les dépendances partiellesasync-api-routes- Démarrer les promesses tôt, attendre tard dans les routes APIasync-suspense-boundaries- Utiliser Suspense pour diffuser le contenu
2. Optimisation de la taille du bundle (CRITIQUE)
bundle-barrel-imports- Importer directement, éviter les fichiers barilbundle-dynamic-imports- Utiliser next/dynamic pour les composants lourdsbundle-defer-third-party- Charger les analyses/ journaux après l'hydratationbundle-conditional- Charger les modules uniquement lorsque la fonctionnalité est activéebundle-preload- Précharger au survol/focus pour une vitesse perçue
3. Performances côté serveur (HAUT)
server-cache-react- Utiliser React.cache() pour la déduplication par requêteserver-cache-lru- Utiliser un cache LRU pour la mise en cache inter-requêtesserver-serialization- Minimiser les données passées aux composants clientserver-parallel-fetching- Restructurer les composants pour paralléliser les récupérationsserver-after-nonblocking- Utiliser after() pour les opérations non bloquantes
4. Récupération de données côté client (MOYEN-HAUT)
client-swr-dedup- Utiliser SWR pour la déduplication automatique des requêtesclient-event-listeners- Dédupliquer les écouteurs d'événements globaux
5. Optimisation des re-rendus (MOYEN)
rerender-defer-reads- Ne pas s'abonner à un état utilisé uniquement dans les callbacksrerender-memo- Extraire le travail coûteux dans des composants mémorisésrerender-dependencies- Utiliser des dépendances primitives dans les effetsrerender-derived-state- S'abonner aux booléens dérivés, pas aux valeurs brutesrerender-functional-setstate- Utiliser setState fonctionnel pour des callbacks stablesrerender-lazy-state-init- Passer une fonction à useState pour les valeurs coûteusesrerender-transitions- Utiliser startTransition pour les mises à jour non urgentes
6. Performances de rendu (MOYEN)
rendering-animate-svg-wrapper- Animer le wrapper div, pas l'élément SVGrendering-content-visibility- Utiliser content-visibility pour les longues listesrendering-hoist-jsx- Extraire le JSX statique en dehors des composantsrendering-svg-precision- Réduire la précision des coordonnées SVGrendering-hydration-no-flicker- Utiliser un script en ligne pour les données côté clientrendering-activity- Utiliser le composant Activity pour afficher/masquerrendering-conditional-render- Utiliser l'opérateur ternaire, pas && pour les conditionnels
7. Performances JavaScript (FAIBLE-MOYEN)
js-batch-dom-css- Grouper les modifications CSS via des classes ou cssTextjs-index-maps- Construire une Map pour les recherches répétéesjs-cache-property-access- Mettre en cache les propriétés d'objets dans les bouclesjs-cache-function-results- Mettre en cache les résultats de fonctions dans une Map au niveau modulejs-cache-storage- Mettre en cache les lectures localStorage/sessionStoragejs-combine-iterations- Combiner plusieurs filter/map en une seule bouclejs-length-check-first- Vérifier la longueur du tableau avant une comparaison coûteusejs-early-exit- Retourner tôt depuis les fonctionsjs-hoist-regexp- Placer la création RegExp en dehors des bouclesjs-min-max-loop- Utiliser une boucle pour min/max au lieu de sortjs-set-map-lookups- Utiliser Set/Map pour les recherches en O(1)js-tosorted-immutable- Utiliser toSorted() pour l'immuabilité
8. Schémas avancés (FAIBLE)
advanced-event-handler-refs- Stocker les gestionnaires d'événements dans des refsadvanced-use-latest- useLatest pour des références de callback stables
Comment utiliser
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
Chaque fichier de règle contient :
- Une brève explication de pourquoi c'est important
- Un exemple de code incorrect avec explication
- Un exemple de code correct avec explication
- Contexte supplémentaire et références
Document compilé complet
Pour le guide complet avec toutes les règles développées : AGENTS.md