Formations — 1 037 leçons en français

Accueil › JavaScript › Lire un message d'erreur

Lire un message d'erreur

Erreurs et débogageavance

Un message d'erreur contient trois informations. Les lire dans cet ordre fait gagner beaucoup de temps.

TypeError: Cannot read properties of undefined (reading 'ville')
    at afficherClient (app.js:42:28)
    at traiterReponse (app.js:17:5)
    at async chargerPage (app.js:9:3)

Le type — TypeError — dit la nature. Le message dit quoi. La pile dit où.

Le message le plus fréquent du langage

Cannot read properties of undefined (reading 'ville')

Il ne dit pas que ville est absente : lire une propriété absente rend undefined sans erreur. Il dit qu'on a lu .ville sur undefined.

client.adresse.ville      // le fautif est « adresse », pas « ville »

Le nom entre guillemets est celui qu'on cherchait ; le coupable est ce qui se trouve juste avant. C'est la lecture qui évite de chercher au mauvais endroit.

La pile se lit de haut en bas

La première ligne est l'endroit de la levée. Mais le cadre utile est le premier qui mentionne votre code : si l'erreur est levée dans une bibliothèque, c'est votre appel qui est fautif.

Les navigateurs savent masquer les cadres tiers — une case à cocher dans les outils de développement, et la pile ne montre plus que vos fichiers.

Les types et ce qu'ils signifient

Type Signifie
TypeError valeur d'un type inattendu — ou fetch hors ligne
ReferenceError nom inexistant, ou let utilisé trop tôt
SyntaxError code ou JSON invalide
RangeError hors bornes, ou pile débordée

Les termes à connaître

Pile d'appels

La liste des fonctions qui ont mené à l'erreur, de la plus récente à la plus ancienne. La première ligne dit où ça a cassé.

Cadre

Une ligne de la pile : un nom de fonction, un fichier, une ligne et une colonne. Les cadres de bibliothèques se sautent.

Carte de sources

Le fichier qui relie le code minifié à l'original. Sans elle, une pile de production ne désigne que index-a1b2.js:1:48392.

Erreur asynchrone

Une erreur survenue depuis une file de tâches. Sa pile ne contient plus le code qui a lancé l'opération — d'où l'intérêt de messages explicites.

Cannot read properties of undefined

Le message le plus fréquent du langage. Il dit toujours la même chose : une valeur attendue n'était pas là, et le nom entre guillemets indique laquelle on cherchait.

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.