Formations — 1 037 leçons en français

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.html pour 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.

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.