Types d'erreurs en programmation : 6 catégories et 8 exemples

Les erreurs de programmation se rangent en six grandes familles : syntaxe, exécution, référence, réseau, logique, et environnement ou configuration. L'intérêt de ce classement n'est pas le vocabulaire : chaque famille laisse des traces différentes. Connaître la famille indique quel message, quelle requête et quelle capture d'écran doivent figurer dans un rapport de bug. Cet article donne d'abord un tableau utilisable tel quel, puis passe en revue les huit erreurs front-end les plus fréquentes — pour montrer qu'une même erreur peut relever de plusieurs familles — et termine par le point concret : comment une erreur devient un rapport qu'un développeur peut traiter sans poser trois questions.

Pourquoi ce classement mérite un article

La plupart des équipes ne butent pas sur la signification de TypeError. Elles butent sur trois autres choses :
  • appeler « bug » toute ligne rouge de la console, alors que la moitié vient de scripts tiers et d'extensions de navigateur ;
  • transmettre « la page ne réagit pas » directement au back-end, alors que le front-end n'a jamais traité la forme de la réponse ;
  • rédiger un rapport qui dit « ça plante » et laisser le développeur demander pendant vingt minutes quelle page, quel navigateur et quel clic.
Ces trois problèmes sont des problèmes de classement : la famille détermine les preuves, et les preuves déterminent si le rapport peut être traité directement.

Les six familles

Famille Quand elle survient Message typique Où se trouve la preuve de première main
Syntaxe Le code ne peut pas être analysé, tout le script s'arrête Unexpected token, Unexpected end of input La première ligne rouge de la console (la suite est souvent une réaction en chaîne)
Exécution Le code s'exécute puis échoue à une étape TypeError, RangeError, Cannot read properties of undefined La console plus l'action qui l'a déclenché
Référence Une variable, un champ ou un module inexistant est utilisé ReferenceError, x is not defined, undefined is not a function La console plus l'URL de la page (quelle route n'a pas chargé)
Réseau Une requête échoue, est bloquée, est cross-origin ou expire 4xx / 5xx, blocked by CORS policy, net::ERR_ Le panneau Réseau : URL, code de statut, en-têtes de réponse
Logique Rien ne plante, mais le résultat est faux Aucun texte rouge Étapes, résultat attendu vs obtenu, un exemple de données
Environnement Seulement sur une machine, un environnement ou un compte Des 404 sans rapport, une page blanche, des ressources qui ne chargent pas Version du navigateur et du système, viewport, marqueur de build ou d'environnement, droits du compte
La colonne la plus utile est la dernière : elle indique quoi mettre dans le rapport. Une erreur de logique n'a pas de message à capturer, il lui faut des étapes et une attente. Une erreur réseau ne s'explique pas par une capture d'écran, il lui faut la requête elle-même.

Syntaxe, exécution, logique : les frontières sont floues

Un même message peut appartenir à plusieurs familles selon la cause, pas selon les mots. Uncaught TypeError: Cannot read properties of undefined (reading 'map') est une erreur d'exécution : le code a atteint une valeur undefined et a appelé .map dessus. Mais la cause peut être :
  • la structure de la réponse API a changé (réseau) ;
  • l'état initial manque d'une valeur par défaut (logique) ;
  • une requête asynchrone n'était pas revenue avant le rendu (timing).
« Ça lève un TypeError » ne suffit donc pas. Le rapport doit contenir la requête d'où viennent les données. C'est aussi pourquoi les erreurs de console et les requêtes en échec vont ensemble : chacune prise seule induit en erreur.

Les huit erreurs front-end les plus fréquentes

# Message Signifie le plus souvent Où regarder
1 TypeError: Cannot read properties of undefined Les données ne sont pas arrivées, la forme ne correspond pas, l'optional chaining manque Console plus la réponse de la requête correspondante
2 ReferenceError: x is not defined Variable non déclarée, ordre des scripts incorrect, module absent du bundle Console plus l'ordre des scripts dans la source
3 blocked by CORS policy Préflight échoué ou Access-Control-Allow-Origin manquant Console plus la requête de préflight dans le panneau Réseau
4 Un point d'accès renvoie 404 / 500 Mauvais chemin, ressource supprimée, exception serveur Réseau : URL, code de statut, résumé de la réponse
5 Hydration failed because the initial UI does not match Le serveur et le client rendent des premiers écrans différents Console plus le composant concerné
6 Unhandled promise rejection Échec asynchrone sans catch, l'erreur disparaît Console plus l'action déclencheuse
7 Refused to load ... violates Content Security Policy La CSP n'autorise pas un nouveau domaine ou un script inline Console plus l'en-tête CSP de la page
8 Mixed Content: ... loaded over HTTPS, but requested an insecure resource Une page HTTPS demande une ressource HTTP Console plus la requête bloquée dans le panneau Réseau
À utiliser comme liste de contrôle : classer d'abord la ligne rouge, puis ajouter la preuve indiquée à droite.

Erreur, bug et défaut ne sont pas synonymes

  • Une erreur est un signal du système. Ce peut être un avertissement, ce peut être du bruit.
  • Un bug est un écart entre l'implémentation et l'attendu, et il demande généralement un chemin reproductible.
  • Un défaut (defect) est ce que la plupart des outils appellent un bug dès qu'il entre en gestion formelle.
La distinction complète est dans Bug vs Defect vs Issue vs Error. Pour celle ou celui qui rédige, une phrase suffit : une erreur est un indice, un bug est une conclusion. Un rapport fournit des indices, pas un verdict.

Quelles preuves pour quelle famille

Famille Le rapport doit contenir Utile, non indispensable
Syntaxe / exécution Le message exact, l'URL, l'action déclencheuse Capture d'écran, courte vidéo
Référence Le message exact, la route en échec, le rôle connecté La forme de la réponse associée
Réseau URL de la requête, code de statut, action, horodatage Extrait de réponse (attention aux champs sensibles)
Logique Étapes, résultat attendu, résultat obtenu, exemple de données Enregistrement d'écran
Environnement Version navigateur et système, viewport, marqueur d'environnement (production, recette, préversion) Droits du compte, numéro de build
La dernière ligne est la plus négligée : « ça n'arrive que sur ma machine » est en soi l'information la plus précieuse du rapport, car elle réduit la recherche de tout le site à une classe d'environnements.

Obtenir ces preuves sans interrogatoire

La voie manuelle passe par les DevTools : capturer la console et le panneau Réseau, puis recaler les horodatages à la main — voir Ouvrir la console du navigateur. Cette voie a trois limites pratiques : les collègues non techniques ne le feront pas, ils ne captureront pas tout, et quelqu'un devra réconcilier les heures. La voie la moins chère est de laisser l'outil de signalement s'en charger. Chaque rapport BugCapturer joint automatiquement l'URL de la page (paramètres sensibles masqués), le navigateur et le système, l'écran et le viewport, un horodatage, les erreurs console mot pour mot et les requêtes en échec (4xx/5xx) avec leur code. La personne entoure la zone et écrit une phrase sur ce qu'elle voit ; les cinq autres colonnes arrivent seules. La différence se voit sur le taux de signalement. Exiger l'apprentissage de la console écarte la plupart des collègues non techniques ; annoter directement sur la page les fait revenir une deuxième fois.

Faut-il un champ « type d'erreur » dans l'outil ?

Si le registre contient déjà quelques centaines de rapports, un champ error_type se justifie — mais seulement dans trois cas :
  • La même famille revient (un CORS une semaine sur deux) : le classement révèle un problème systémique au lieu d'un ticket à la fois.
  • La personne qui signale n'est pas développeuse : le classement supprime l'aller-retour « front ou back ».
  • Vous mesurez la qualité : la répartition par type est plus juste que la répartition par personne.
  • Si l'équipe compte trois à cinq personnes et moins de vingt rapports par semaine, le champ n'ajoute que de la saisie. Complétez d'abord les preuves, parlez de classement ensuite.

    Trois erreurs fréquentes

    • Traiter chaque ligne rouge comme un bug : extensions, scripts d'analytics et bloqueurs de publicité écrivent tous dans la console. Le critère est l'effet sur le comportement de la page.
    • Ignorer les avertissements : les avertissements de clé React, d'hydratation et de dépréciation ne sont pas des bugs, mais en sont souvent l'annonce.
    • Transférer un 500 directement au back-end : le code indique un échec serveur, mais le rapport manque encore l'URL, les noms de paramètres et l'action. Sans ces trois éléments, la réponse sera « reproduisez ».

    FAQ

    Une erreur de syntaxe est-elle un bug ? Dans le code source, elle n'atteint normalement pas la production : le build l'arrête. Si un SyntaxError apparaît en production, la chaîne de publication est en cause — build non validé ou CDN servant un fichier ancien — et cela se traite comme un défaut. Faut-il mettre les avertissements console dans le rapport ? Seulement ceux liés au symptôme. Une page blanche avec un avertissement d'hydratation oui ; un avis de dépréciation d'une bibliothèque non, il enterre le vrai indice. Un « API 500 », c'est front-end ou back-end ? Qui corrige dépend de votre processus, mais le contenu du rapport est identique : URL, code de statut, action, horodatage et reproductibilité. Établissez d'abord si le front-end a envoyé de mauvais paramètres ou si le serveur a réellement échoué. Pourquoi le développeur dit-il toujours « je ne reproduis pas » ? Parce que ce qui manque est un environnement, pas des étapes : droits, volume de données, version de navigateur, fuseau horaire et feature flags diffèrent. Un champ d'environnement dans le rapport supprime cet aller-retour. Comment des collègues non techniques produisent-ils des rapports utiles ? Ne leur apprenez pas les DevTools. Installez une extension de navigateur, ou intégrez un point d'entrée de feedback sur le site, et laissez l'outil collecter la console et les requêtes en échec — c'est la condition d'un système de feedback instantané.