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