Sortie de Inertia 5.0.0 : Support de Inertia 3 et couverture complète du protocole
· Impact sur votre code : élevé
Le package @adonisjs/inertia a publié la version 5.0.0, mettant à niveau pour supporter Inertia 3 et implémentant la surface du protocole v3 côté serveur. Cette version introduit plusieurs fonctionnalités côté serveur telles que les props once, les fusions keyées et directionnelles, le défilement infini, les props différées récupérées, les messages flash de première classe, le suivi des props partagées, et le support de multiples erreurs de validation par champ. Côté client, elle ajoute useRouter conscient des routes, des chaînes de requête typées, des surcharges de méthode sur les routes multi-méthodes, useHttp typé, des visites instantanées corrélées, et des wrappers améliorés pour Vue et React. Le plugin @adonisjs/inertia/vite a été supprimé au profit de l'utilisation des serverEntrypoints de @adonisjs/vite v6. La mise à niveau nécessite React 19 ou Vue 3.5 en raison des changements de dépendances peer du client Inertia 3. Plusieurs changements majeurs et étapes de migration sont détaillés, incluant des modifications de la configuration SSR et des noms d'événements client.
Les développeurs doivent mettre à jour les bibliothèques clientes Inertia 3 (React 19 ou Vue 3.5), supprimer le plugin @adonisjs/inertia/vite et migrer la configuration SSR pour utiliser les serverEntrypoints de @adonisjs/vite. Le code côté client doit s'adapter aux renommages des événements Inertia et aux API mises à jour. Les nouvelles fonctionnalités côté serveur et les typings clients permettent une utilisation Inertia plus robuste et typée, mais nécessitent des modifications de code. La gestion des erreurs de validation et des messages flash a été améliorée, ce qui requiert des mises à jour des middlewares et du code client. La migration implique des mises à jour de paquets, des changements de configuration et l'adaptation aux nouvelles API client.
- Mettre à jour @adonisjs/inertia et @adonisjs/vite vers les dernières versions.
- Mettre à jour @inertiajs/react ou @inertiajs/vue3 vers la version ^3.4.0.
- Supprimer le plugin @adonisjs/inertia/vite de vite.config.ts.
- Configurer les points d'entrée SSR en utilisant l'option serverEntrypoints de @adonisjs/vite.
- Supprimer l'option ssr.bundle de config/inertia.ts, ne conserver que ssr.entrypoint.
- Mettre à jour le code frontend pour gérer les changements majeurs du client Inertia 3 (renommage des événements, changements d'API).
- Adapter les middlewares pour implémenter le hook flash() optionnel pour les messages flash de première classe.
- Utiliser les nouvelles fonctionnalités côté serveur comme les props once, les fusions keyées, le défilement infini et les props différées récupérées selon les besoins.
- Mettre à jour l'utilisation côté client pour exploiter useRouter conscient des routes, les chaînes de requête typées, les surcharges de méthode et useHttp typé.
- Adapter la gestion des erreurs de validation pour supporter plusieurs erreurs par champ si désiré.
Sources originales
Analyse générée par IA à partir des sources citées. Consultez la documentation originale avant de modifier votre application.