Accueil › React › Journalisation des erreurs et déploiement
Journalisation des erreurs et déploiement
Mise en productionavance
Une erreur chez un visiteur, sans journalisation, est une erreur que vous n'apprendrez que par un client mécontent — ou jamais.
Capturer ce qui échappe
// Une frontière d'erreur attrape les erreurs de rendu…
<FrontiereErreur onErreur={(e, info) => journaliser(e, info)}>
<App />
</FrontiereErreur>
// …et ces deux écouteurs le reste
window.addEventListener("error", (e) => journaliser(e.error));
window.addEventListener("unhandledrejection", (e) => journaliser(e.reason));
Une frontière d'erreur ne voit pas ce qui se passe dans un gestionnaire d'événement, un minuteur, ou une promesse rejetée. Les trois mécanismes sont complémentaires.
Les cartes de source
// vite.config.js
build: { sourcemap: "hidden" }
hidden les produit sans les référencer depuis le code publié : le service de
journalisation les reçoit, les visiteurs ne les voient pas. Sans elles, une
trace ressemble à ceci :
at a (index-a3f9.js:1:48213)
Le réglage d'hébergement à ne pas oublier
/* /index.html 200
Sans cette règle, recharger /clients/42 donne un 404 : le serveur cherche un
fichier à ce chemin. La navigation interne fonctionne pourtant très bien — le
routeur intercepte les clics. Le bogue n'apparaît donc qu'après la mise en
ligne.
Le cache, par type de fichier
| Fichier | En-tête |
|---|---|
assets/*-a3f9.js (empreinte) |
max-age=31536000, immutable |
index.html |
no-cache |
La chaîne de publication
pousser → vérifier → construire → publier → prévisualiser
Si la vérification échoue, rien n'est publié. C'est tout l'intérêt.
Les termes à connaître
- Journalisation des erreurs
Envoyer les erreurs survenues chez les visiteurs à un service qui les regroupe. Sans cela, on apprend les pannes par les clients.
- Carte de source (source map)
Le fichier qui relie le code minifié au code d'origine. Sans elle, une trace d'erreur en production est illisible.
- Réécriture vers index.html
La règle d'hébergement qui renvoie
index.htmlpour toute URL inconnue. Sans elle, recharger une page profonde donne un 404.- Intégration continue
Le pipeline qui vérifie et construit à chaque poussée. Son rôle est d'empêcher qu'un contenu invalide soit publié.
- Retour arrière
Republier la version précédente. C'est la mesure qui compte vraiment : la question n'est pas d'éviter les pannes mais d'en sortir vite.
- Déploiement de prévisualisation
Une URL propre à chaque branche. Elle permet de regarder le résultat avant la fusion, au lieu de l'imaginer.
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.