Formations — 1 037 leçons en français

Accueil › JavaScript › Les erreurs qu'on ne voit pas

Les erreurs qu'on ne voit pas

Erreurs et débogageavance

En production, vous ne voyez pas ce qui casse. L'utilisateur voit une page blanche, referme l'onglet, et ne vous écrit pas.

Le filet de la dernière chance

// à poser une fois, au démarrage
window.addEventListener("error", (e) => remonter(e.error ?? e.message));
window.addEventListener("unhandledrejection", (e) => remonter(e.reason));

Les deux sont nécessaires : le second couvre les promesses rompues sans catch, c'est-à-dire la majorité des erreurs d'une application moderne.

Ils ne remplacent aucun catch. Ils rattrapent ce qui a échappé.

Ce qu'il faut remonter

function remonter(erreur) {
  envoyer({
    message: erreur?.message ?? String(erreur),
    pile: erreur?.stack,
    url: location.href,
    navigateur: navigator.userAgent,
    version: import.meta.env.VITE_VERSION,     // quelle version du code
    horodatage: new Date().toISOString(),
  });
}

La version est le champ qu'on oublie, et le plus utile : elle dit si le bogue est apparu avec le dernier déploiement.

Ce qu'on montre à l'utilisateur

// ❌
afficher(erreur.stack);

// ✅
afficher("Impossible d'enregistrer. Vérifiez votre connexion et réessayez.");

Une pile d'appels n'aide pas l'utilisateur, et renseigne un attaquant. Le bon message dit ce qui s'est passé et quoi faire.

Le message utile

Situation Message
Hors ligne « Vous semblez hors connexion. »
401 « Votre session a expiré. Reconnectez-vous. »
403 « Vous n'avez pas accès à cette page. »
404 « Cet élément n'existe plus. »
5xx « Problème de notre côté. Réessayez dans un instant. »
Inattendu « Une erreur inattendue est survenue. Incident 7f3a2. »

Chacun suggère une action différente. « Une erreur est survenue » n'en suggère aucune.

Les termes à connaître

Suivi d'erreurs

Un service qui reçoit les erreurs des navigateurs de vos utilisateurs, les regroupe et les classe. Sans lui, vous ne savez rien de ce qui casse chez eux.

unhandledrejection

L'événement global des rejets de promesse non gérés. Avec error, il forme le filet de la dernière chance.

Regroupement

Le rapprochement de milliers d'occurrences d'un même bogue en une seule entrée. C'est ce qui rend un tableau de bord lisible.

Fil d'Ariane

La suite des actions précédant l'erreur — clics, navigations, requêtes. Elle remplace le « que faisiez-vous ? » qu'on ne peut pas poser.

Échantillonnage

N'envoyer qu'une fraction des événements. Nécessaire sur un gros trafic, et à ne jamais appliquer aux erreurs elles-mêmes.

Message utilisateur

Ce qu'on montre à l'écran : ce qui s'est passé et quoi faire. Jamais une pile d'appels, jamais « Error: undefined ».

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.