L’architecture documentée de Next.js
Next.js repose sur React et fournit une couche de framework pour le routage, le rendu, l’accès aux données, les points de terminaison serveur, la compilation et la création de bundles. Cela décrit le modèle de programmation public documenté pour les applications ; cela ne révèle pas l’infrastructure privée utilisée pour exploiter nextjs.org.
Dans l’App Router, l’arborescence des routes est organisée au moyen de fichiers pour les pages, les mises en page, les états de chargement, les erreurs et les comportements associés. Les mises en page et les pages sont des Server Components par défaut. Les Client Components définissent des sous-arbres exécutés dans le navigateur pour l’état, les gestionnaires d’événements, les effets et les API réservées au navigateur.
Couches publiques du framework
| Couche | Responsabilité documentée |
|---|---|
| Composants React | Composer l’interface utilisateur et définir les arborescences de composants serveur ou client |
| App Router ou Pages Router | Associer la structure de l’application aux routes à l’aide de différents modèles Next.js |
| Système de rendu | Produire une sortie pré-rendue ou générée au moment de la requête et coordonner la diffusion en continu lorsqu’elle s’applique |
| Mise en cache et revalidation | Contrôler la réutilisation et l’actualisation selon le comportement des routes et des données |
| Route Handlers | Implémenter des points de terminaison HTTP au sein d’une application App Router |
| Outils de compilation | Compiler et regrouper le code et les ressources de l’application pour les déploiements pris en charge |
Une route Next.js peut inclure du contenu rendu côté serveur et une interaction client ciblée. La présence d’un Client Component ne transforme pas tous ses ancêtres en application rendue dans le navigateur, bien que la frontière client choisie affecte les modules inclus pour le navigateur.
Choix de diffusion
- L’exportation statique produit des fichiers pour les projets qui ne nécessitent pas de fonctionnalités serveur non prises en charge.
- Le pré-rendu prépare la sortie d’une route avant une requête individuelle.
- Le rendu dynamique produit une sortie à l’aide d’informations disponibles au moment de la requête.
- La mise en cache et la revalidation gèrent la réutilisation et l’actualisation entre ces deux extrêmes.
- Un environnement d’exécution compatible est nécessaire pour les comportements au moment des requêtes et les autres comportements dépendant du serveur.
Le guide de déploiement officiel documente l’auto-hébergement et les adaptateurs de plateformes ; Vercel n’est donc pas une exigence technique pour toutes les applications Next.js. La couverture fonctionnelle peut varier selon les environnements. Les équipes devraient vérifier le routage, la mise en cache, le comportement des images, la revalidation, la diffusion en continu et les Route Handlers par rapport à la cible sélectionnée, plutôt que de déduire la compatibilité d’une compilation réussie.
