Accueil › Vue.js › Journalisation des erreurs et déploiement
Journalisation des erreurs et déploiement
Mise en productionavance
Une erreur en production n'a pas de console ouverte devant elle. Vue fournit deux points de collecte.
// main.js
app.config.errorHandler = (err, instance, info) => {
envoyerAuCollecteur({ message: String(err), origine: info })
}
errorHandler reçoit les erreurs non rattrapées venant des composants : rendu,
observateurs, gestionnaires d'événement, crochets de cycle de vie. L'argument
info indique d'où elle vient.
// Un composant qui protège sa descendance
onErrorCaptured((err, instance, info) => {
enPanne.value = true
return false // arrête la remontée
})
onErrorCaptured intercepte les erreurs des composants enfants. Renvoyer
false arrête la propagation — y compris vers errorHandler, ce qui rend
l'erreur invisible pour votre journalisation.
Côté déploiement, trois points décident du succès.
Le repli d'historique : en mode historique, le serveur doit renvoyer
index.html pour toute URL inconnue, sinon /commandes/42 donne un 404 au
rafraîchissement.
Le cache : les fichiers empreintés supportent une durée très longue et
immutable ; index.html ne doit surtout pas être mis en cache longtemps,
puisque c'est lui qui désigne les autres.
La base : si l'application n'est pas servie à la racine du domaine, Vite et le routeur doivent le savoir tous les deux.
Les termes à connaître
- app.config.errorHandler
Crochet global appelé pour les erreurs non rattrapées venant des composants : rendu, observateurs, gestionnaires d'événement, crochets de cycle de vie.
- onErrorCaptured
Crochet de composant qui intercepte les erreurs de sa descendance. Renvoyer
falsearrête la remontée vers les ancêtres.- Carte de source
Fichier
.mapqui relie le code minifié au code d'origine. Indispensable pour lire une pile d'appels de production.- Repli d'historique
La règle serveur qui renvoie
index.htmlpour toute URL inconnue, nécessaire au mode historique de Vue Router.- base
Option Vite indiquant le chemin public sous lequel l'application est servie. Elle doit correspondre à la base du routeur.
- Immuable
Directive de cache indiquant qu'un fichier ne changera jamais à cette URL. Réservée aux fichiers dont le nom porte une empreinte.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.