Bonnes 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 l'appliquer
Référencez ces directives lorsque :
- Vous écrivez de nouveaux composants React ou pages Next.js
- Vous implémentez du data fetching (côté client ou serveur)
- Vous relisez du code pour des problèmes de performance
- Vous refactorez du code React/Next.js existant
- Vous 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 | Performance côté serveur | HAUTE | server- |
| 4 | Data fetching côté client | MOYENNE-HAUTE | client- |
| 5 | Optimisation des re-rendus | MOYENNE | rerender- |
| 6 | Performance de rendu | MOYENNE | rendering- |
| 7 | Performance JavaScript | FAIBLE-MOYENNE | js- |
| 8 | Schémas avancés | FAIBLE | advanced- |
Référence rapide
1. Élimination des cascades (CRITIQUE)
async-defer-await- Déplacez await dans les branches où il est réellement utiliséasync-parallel- Utilisez Promise.all() pour les opérations indépendantesasync-dependencies- Utilisez better-all pour les dépendances partiellesasync-api-routes- Démarrez les promesses tôt, attendez tard dans les routes APIasync-suspense-boundaries- Utilisez Suspense pour diffuser du contenu
2. Optimisation de la taille du bundle (CRITIQUE)
bundle-barrel-imports- Importez directement, évitez les fichiers barilbundle-dynamic-imports- Utilisez next/dynamic pour les composants lourdsbundle-defer-third-party- Chargez l'analytique/la journalisation après l'hydratationbundle-conditional- Chargez les modules uniquement lorsque la fonctionnalité est activéebundle-preload- Préchargez au survol/au focus pour une vitesse perçue
3. Performance côté serveur (HAUTE)
server-cache-react- Utilisez React.cache() pour la déduplication par requêteserver-cache-lru- Utilisez un cache LRU pour la mise en cache inter-requêtesserver-serialization- Minimisez les données passées aux composants clientserver-parallel-fetching- Restructurez les composants pour paralléliser les fetchserver-after-nonblocking- Utilisez after() pour les opérations non bloquantes
4. Data fetching côté client (MOYENNE-HAUTE)
client-swr-dedup- Utilisez SWR pour la déduplication automatique des requêtesclient-event-listeners- Dédupliquez les écouteurs d'événements globaux
5. Optimisation des re-rendus (MOYENNE)
rerender-defer-reads- Ne vous abonnez pas à un état utilisé uniquement dans les callbacksrerender-memo- Extrayez les opérations coûteuses dans des composants mémoïzésrerender-dependencies- Utilisez des dépendances primitives dans les effetsrerender-derived-state- Abonnez-vous à des booléens dérivés, pas aux valeurs brutesrerender-functional-setstate- Utilisez setState fonctionnel pour des callbacks stablesrerender-lazy-state-init- Passez une fonction à useState pour les valeurs coûteusesrerender-transitions- Utilisez startTransition pour les mises à jour non urgentes
6. Performance de rendu (MOYENNE)
rendering-animate-svg-wrapper- Animez le wrapper div, pas l'élément SVGrendering-content-visibility- Utilisez content-visibility pour les longues listesrendering-hoist-jsx- Extrayez le JSX statique hors des composantsrendering-svg-precision- Réduisez la précision des coordonnées SVGrendering-hydration-no-flicker- Utilisez un script en ligne pour les données côté client uniquementrendering-activity- Utilisez le composant Activity pour afficher/masquerrendering-conditional-render- Utilisez l'opérateur ternaire, pas && pour les conditions
7. Performance JavaScript (FAIBLE-MOYENNE)
js-batch-dom-css- Groupez les changements CSS via des classes ou cssTextjs-index-maps- Construisez une Map pour les recherches répétéesjs-cache-property-access- Mettez en cache les propriétés d'objets dans les bouclesjs-cache-function-results- Mettez en cache les résultats de fonctions dans une Map au niveau du modulejs-cache-storage- Mettez en cache les lectures de localStorage/sessionStoragejs-combine-iterations- Combinez plusieurs filter/map en une seule bouclejs-length-check-first- Vérifiez la longueur du tableau avant une comparaison coûteusejs-early-exit- Retournez tôt des fonctionsjs-hoist-regexp- Déplacez la création de RegExp hors des bouclesjs-min-max-loop- Utilisez une boucle pour min/max au lieu de sortjs-set-map-lookups- Utilisez Set/Map pour les recherches en O(1)js-tosorted-immutable- Utilisez toSorted() pour l'immuabilité
8. Schémas avancés (FAIBLE)
advanced-event-handler-refs- Stockez 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 l'importance de la règle
- Un exemple de code incorrect avec explication
- Un exemple de code correct avec explication
- Contexte supplémentaire et références
Document complet compilé
Pour le guide complet avec toutes les règles développées : AGENTS.md