Bonnes pratiques React de Vercel
Guide complet d'optimisation des performances pour les applications React et Next.js, maintenu par Vercel. Contient 70 règles réparties en 8 catégories, classées par priorité d'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
- Vous implémentez la récupération de données (côté client ou serveur)
- Vous révisez 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 | Récupération de données côté client | MOYENNE-HAUTE | client- |
| 5 | Optimisation des re-rendus | MOYENNE | rerender- |
| 6 | Performance de rendu | MOYENNE | rendering- |
| 7 | Performance JavaScript | BASSE-MOYENNE | js- |
| 8 | Schémas avancés | BASSE | advanced- |
Référence rapide
1. Élimination des cascades (CRITIQUE)
async-cheap-condition-before-await- Vérifiez les conditions synchrones peu coûteuses avant d'attendre des flags ou des valeurs distantesasync-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- Lancez les promesses tôt, attendez tard dans les routes d'APIasync-suspense-boundaries- Utilisez Suspense pour diffuser le contenu
2. Optimisation de la taille du bundle (CRITIQUE)
bundle-barrel-imports- Importez directement, évitez les fichiers barrelbundle-analyzable-paths- Préférez les chemins d'import et de système de fichiers statiquement analysables pour éviter les bundles et les traces trop largesbundle-dynamic-imports- Utilisez next/dynamic pour les composants lourdsbundle-defer-third-party- Chargez l'analyse/le logging après l'hydratationbundle-conditional- Chargez les modules uniquement lorsque la fonctionnalité est activéebundle-preload- Préchargez au survol/au focus pour la vitesse perçue
3. Performance côté serveur (HAUTE)
server-auth-actions- Authentifiez les actions serveur comme les routes d'APIserver-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-dedup-props- Évitez la sérialisation en double dans les propriétés RSCserver-hoist-static-io- Remontez les E/S statiques (polices, logos) au niveau du moduleserver-no-shared-module-state- Évitez les états de requête mutables au niveau du module dans RSC/SSRserver-serialization- Minimisez les données passées aux composants clientserver-parallel-fetching- Restructurez les composants pour paralléliser les récupérationsserver-parallel-nested-fetching- Enchaînez les récupérations imbriquées par élément dans Promise.allserver-after-nonblocking- Utilisez after() pour les opérations non bloquantes
4. Récupération de données 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 globauxclient-passive-event-listeners- Utilisez des écouteurs passifs pour le défilementclient-localstorage-schema- Versionnez et minimisez les données localStorage
5. Optimisation des re-rendus (MOYENNE)
rerender-defer-reads- Ne vous abonnez pas à un état utilisé uniquement dans les callbacksrerender-memo- Extrayez le travail coûteux dans des composants mémorisésrerender-memo-with-default-value- Remontez les propriétés non primitives par défautrerender-dependencies- Utilisez des dépendances primitives dans les effetsrerender-derived-state- Abonnez-vous aux booléens dérivés, pas aux valeurs brutesrerender-derived-state-no-effect- Dérivez l'état pendant le rendu, pas dans les effetsrerender-functional-setstate- Utilisez setState fonctionnel pour des callbacks stablesrerender-lazy-state-init- Passez une fonction à useState pour les valeurs coûteusesrerender-simple-expression-in-memo- Évitez memo pour les primitives simplesrerender-split-combined-hooks- Séparez les hooks avec des dépendances indépendantesrerender-move-effect-to-event- Placez la logique d'interaction dans les gestionnaires d'événementsrerender-transitions- Utilisez startTransition pour les mises à jour non urgentesrerender-use-deferred-value- Différez les rendus coûteux pour garder l'entrée réactivererender-use-ref-transient-values- Utilisez des refs pour les valeurs transitoires fréquentesrerender-no-inline-components- Ne définissez pas de composants à l'intérieur d'autres composants
6. Performance de rendu (MOYENNE)
rendering-animate-svg-wrapper- Animez un wrapper div, pas l'élément SVGrendering-content-visibility- Utilisez content-visibility pour les longues listesrendering-hoist-jsx- Extrayez le JSX statique à l'extérieur 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-hydration-suppress-warning- Supprimez les avertissements de discordance attendusrendering-activity- Utilisez le composant Activity pour afficher/masquerrendering-conditional-render- Utilisez l'opérateur ternaire, pas &&, pour les conditionnellesrendering-usetransition-loading- Préférez useTransition pour l'état de chargementrendering-resource-hints- Utilisez les indications de ressources React DOM pour le préchargementrendering-script-defer-async- Utilisez defer ou async sur les balises script
7. Performance JavaScript (BASSE-MOYENNE)
js-batch-dom-css- Regroupez les modifications 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'objet dans les bouclesjs-cache-function-results- Mettez en cache les résultats de fonction 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 d'un tableau avant une comparaison coûteusejs-early-exit- Retournez tôt des fonctionsjs-hoist-regexp- Remontez la création de RegExp en dehors 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éjs-flatmap-filter- Utilisez flatMap pour mapper et filtrer en un seul passagejs-request-idle-callback- Différez le travail non critique au temps d'inactivité du navigateur
8. Schémas avancés (BASSE)
advanced-effect-event-deps- Ne mettez pas les résultats deuseEffectEventdans les dépendances de l'effetadvanced-event-handler-refs- Stockez les gestionnaires d'événements dans des refsadvanced-init-once- Initialisez l'application une fois par chargementadvanced-use-latest- useLatest pour des refs de callback stables
Comment utiliser
Lisez les fichiers de règles individuelles pour des explications détaillées et des exemples de code :
rules/async-parallel.md
rules/bundle-barrel-imports.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 complet compilé
Pour le guide complet avec toutes les règles développées : AGENTS.md