Lire une stack trace

Objectifs

À la fin de cette leçon, vous saurez :

• décoder la structure d'une stack trace Node ;
• identifier fichier, ligne, fonction et origine du plantage ;
• distinguer l'endroit du crash de la cause du crash.

🔗 Pour vous rafraîchir la mémoire : les trois familles d'erreurs

Fabriquons volontairement un plantage

Créez plante.js :

function calculerMoyenne(notes) {
  const total = notes.reduce((somme, n) => somme + n, 0);
  return total / notes.length;
}

function traiterClasse(classe) {
  return calculerMoyenne(classe.notes);
}

traiterClasse({ eleve: "Paul" });

Exécution :

node plante.js

Résultat :

C:\...\plante.js:8
  const total = notes.reduce((somme, n) => somme + n, 0);
                        ^
TypeError: Cannot read properties of undefined (reading 'reduce')
    at calculerMoyenne (C:\...\plante.js:2:23)
    at traiterClasse (C:\...\plante.js:5:10)
    at Object.<anonymous> (C:\...\plante.js:7:1)
    ...

Anatomie d'une stack trace

Trois blocs à distinguer :

1. La ligne fautive, reproduite avec son curseur :

const total = notes.reduce(...)
                  ^

2. Le type et le message : TypeError + « Cannot read properties of undefined (reading 'reduce') ». Traduction : on a tenté d'appeler .reduce sur undefined.

3. La pile d'appels (stack), de haut en bas :

at calculerMoyenne (...)   ← là où le crash a eu lieu
at traiterClasse (...)     ← qui appelait calculerMoyenne
at Object.<anonymous>      ← le niveau racine du fichier

La pile se lit comme une pile d'assiettes : le haut est le dernier geste posé (le crash), chaque niveau en dessous est qui a demandé ce geste.

Le réflexe complet

1. Lire le type (TypeError) : famille de problème.
2. Lire le message en entier : quelle propriété, sur quelle valeur.
3. Regarder la première ligne de la pile : où ça a cassé.
4. Remonter les lignes suivantes : par quoi ça a été déclenché.
5. Se poser LA question : pourquoi cette valeur vaut-elle undefined ici ?

Crash ≠ cause

Dans notre exemple, le crash a lieu dans calculerMoyenne, mais la cause est ailleurs : traiterClasse a transmis un objet sans propriété notes. Corriger la ligne 2 ne servirait à rien ; il faut soit transmettre les bonnes données, soit défendre l'accès :

if (!classe.notes) {
  throw new Error("Classe sans notes : " + classe.eleve);
}

Message clair + plantage immédiat au bon endroit valent mieux qu'un comportement silencieux faux.

Les colonnes ligne:colonne

Chaque référence est fichier:ligne:colonne. Dans plante.js:2:23, la colonne pointe précisément l'expression .reduce. Avec des éditeurs modernes, Ctrl+clic sur ces références ouvre directement l'emplacement.

Erreurs chaînées

Une erreur peut en cacher une autre : la trace se termine parfois par Caused by: — lisez alors les deux piles, celle de l'erreur finale ET celle de sa cause première.

Exercice

Analysez cette trace sans exécuter quoi que ce soit :

TypeError: Cannot read properties of undefined (reading 'push')
    at ajouterTache (C:\proj\todo.js:12:9)
    at gererJournee (C:\proj\agenda.js:40:3)
    at main (C:\proj\index.js:5:5)

1. Quel type d'erreur ? Que signifie-t-il ?
2. Quelle ligne planterait à coup sûr si on y allait ?
3. Qui a appelé la fonction fautrice ?
4. Proposez deux hypothèses de cause possibles.
5. Pourquoi corriger la ligne 12 de todo.js ne suffirait probablement pas ?

Résumé

• Stack trace = message + pile d'appels ; on lit le haut pour le lieu, le bas pour le contexte.
• fichier:ligne:colonne localise exactement l'expression fautive.
• L'endroit du crash n'est pas toujours la cause : remonter la pile.
• Un plantage précoce avec message explicite vaut mieux qu'un silence trompeur.