Formations — 1 037 leçons en français

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 false arrête la remontée vers les ancêtres.

Carte de source

Fichier .map qui 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.html pour 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.

Lire l'explication détaillée et faire le quiz →

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.