Tipos de errores en programación: 6 categorías y 8 ejemplos

Los errores de programación se agrupan en seis familias: sintaxis, ejecución, referencia, red, lógica y entorno o configuración. El valor de esta clasificación no está en el vocabulario, sino en que cada familia deja pruebas distintas. Saber la familia indica qué mensaje, qué petición y qué captura debe llevar un informe de bug. Este artículo da primero una tabla que se puede usar tal cual, después repasa los ocho errores front-end más frecuentes —para mostrar que un mismo error puede caer en varias familias— y termina en lo práctico: cómo un error se convierte en un informe que un desarrollador puede atender sin hacer tres preguntas.

Por qué la clasificación merece un artículo propio

La mayoría de los equipos no tiene un problema de comprensión con TypeError. Tiene problemas con otras tres cosas:
  • llamar bug a toda línea roja de la consola, cuando la mitad viene de scripts de terceros y extensiones del navegador;
  • pasar «la página no hace nada» directamente al backend, cuando el front-end nunca manejó la forma de la respuesta;
  • redactar un informe que dice «da error» y dejar al desarrollador veinte minutos preguntando qué página, qué navegador y qué se pulsó.
Los tres son problemas de clasificación: la familia determina la evidencia, y la evidencia determina si el informe se puede corregir directamente.

Las seis familias

Familia Cuándo ocurre Mensaje típico Dónde está la prueba de primera mano
Sintaxis El código no se puede analizar, todo el script se detiene Unexpected token, Unexpected end of input La primera línea roja de la consola (lo siguiente suele ser efecto en cadena)
Ejecución El código se ejecuta y falla en un paso TypeError, RangeError, Cannot read properties of undefined Consola más la acción que lo disparó
Referencia Se usa una variable, campo o módulo que no existe ReferenceError, x is not defined, undefined is not a function Consola más la URL (qué ruta no cargó)
Red Una petición falla, se bloquea, es cross-origin o expira 4xx / 5xx, blocked by CORS policy, net::ERR_ Panel Red: URL, código de estado, cabeceras de respuesta
Lógica Nada lanza error, pero el resultado es incorrecto Ningún texto en rojo Pasos, resultado esperado vs real, una muestra de datos
Entorno Solo en una máquina, un entorno o una cuenta 404 sin relación, página en blanco, recursos que no cargan Versión de navegador y sistema, viewport, marcador de build o entorno, permisos de la cuenta
La columna más útil es la última: dice qué poner en el informe. Un error de lógica no tiene mensaje que capturar, así que necesita pasos y expectativas. Un error de red no se explica con una captura, así que necesita la petición.

Sintaxis, ejecución, lógica: los límites son difusos

Un mismo mensaje puede pertenecer a familias distintas según la causa, no según el texto. Uncaught TypeError: Cannot read properties of undefined (reading 'map') es un error de ejecución: el código llegó a un undefined y llamó a .map sobre él. Pero la causa puede ser:
  • cambió la estructura de la respuesta de la API (red);
  • al estado inicial le falta un valor por defecto (lógica);
  • una petición asíncrona no había vuelto antes del render (timing).
Por eso «lanza un TypeError» no basta. El informe necesita la petición de la que salieron los datos. También por eso los errores de consola y las peticiones fallidas van juntos: cualquiera de los dos por separado lleva a conclusiones erróneas.

Los ocho errores front-end más frecuentes

# Mensaje Suele significar Dónde mirar
1 TypeError: Cannot read properties of undefined Los datos no llegaron, la forma no coincide, falta optional chaining Consola más la respuesta de la petición correspondiente
2 ReferenceError: x is not defined Variable no declarada, orden de scripts incorrecto, módulo ausente del bundle Consola más el orden de scripts en el código fuente
3 blocked by CORS policy Preflight fallido o falta Access-Control-Allow-Origin Consola más la petición de preflight en el panel Red
4 Un endpoint devuelve 404 / 500 Ruta incorrecta, recurso eliminado, excepción del servidor Red: URL, código de estado, resumen de la respuesta
5 Hydration failed because the initial UI does not match Servidor y cliente renderizaron primeras pantallas distintas Consola más el componente implicado
6 Unhandled promise rejection Fallo asíncrono sin catch, el error desaparece Consola más la acción que lo disparó
7 Refused to load ... violates Content Security Policy La CSP no permite un dominio nuevo o un script inline Consola más la cabecera CSP de la página
8 Mixed Content: ... loaded over HTTPS, but requested an insecure resource Una página HTTPS pide un recurso HTTP Consola más la petición bloqueada en el panel Red
Sirve como lista de comprobación: clasifica primero la línea roja y añade después la prueba que indica la columna derecha.

Error, bug y defecto no son lo mismo

  • Un error es una señal del sistema. Puede ser un aviso; puede ser ruido.
  • Un bug es una discrepancia entre implementación y expectativa, y normalmente necesita un camino reproducible.
  • Un defecto es lo que la mayoría de las herramientas llama bug cuando entra en gestión formal.
La distinción completa está en Bug vs Defect vs Issue vs Error. Para quien informa, una frase basta: un error es una pista, un bug es una conclusión. El informe aporta pistas, no dicta sentencia.

Qué prueba necesita cada familia

Familia El informe debe contener Útil, no imprescindible
Sintaxis / ejecución Mensaje exacto, URL, acción que lo disparó Captura, grabación corta
Referencia Mensaje exacto, ruta que falló, rol con sesión iniciada Forma de la respuesta asociada
Red URL de la petición, código de estado, acción, marca de tiempo Fragmento de la respuesta (con campos sensibles enmascarados)
Lógica Pasos, resultado esperado, resultado real, muestra de datos Grabación de pantalla
Entorno Versión de navegador y sistema, viewport, marcador de entorno (producción, staging, preview) Permisos de la cuenta, número de build
La última fila es la más ignorada: «solo pasa en mi máquina» es en sí misma la información más valiosa del informe, porque reduce la búsqueda de todo el sitio a una clase de entorno.

Conseguir la prueba sin interrogar a nadie

La vía manual es abrir DevTools, capturar la consola y el panel Red y cuadrar las horas a mano — ver Cómo abrir la consola del navegador. Esa vía tiene tres problemas prácticos: los compañeros no técnicos no lo harán, no lo capturarán todo, y alguien tendrá que reconciliar las horas después. La vía barata es dejar que la herramienta de reporte lo lleve. Cada informe de BugCapturer adjunta la URL de la página (con parámetros sensibles enmascarados), navegador y sistema, pantalla y viewport, marca de tiempo, los errores de consola literales y las peticiones fallidas (4xx/5xx) con su código. La persona marca la zona y escribe una frase sobre lo que ve; las otras cinco columnas llegan solas. La diferencia se nota en la tasa de envío. Exigir que alguien aprenda la consola deja fuera a la mayoría de los compañeros no técnicos; anotar directamente sobre la página hace que envíen un segundo informe.

¿Hace falta un campo «tipo de error»?

Si el registro ya tiene unos cientos de informes, un campo error_type se gana su sitio, pero solo en tres casos:
  • La misma familia vuelve (un CORS cada dos semanas): la clasificación revela un problema sistémico en lugar de un ticket por vez.
  • Quien informa no es desarrollador: la clasificación elimina el ida y vuelta «front o back».
  • Medís calidad: la distribución por tipo es más justa que la distribución por persona.
  • Si el equipo son tres o cinco personas con menos de veinte informes por semana, el campo solo añade escritura. Primero completad la evidencia; después hablad de clasificar.

    Tres errores frecuentes

    • Tratar toda línea roja como bug: extensiones, scripts de analítica y bloqueadores escriben en la consola. El criterio es si cambia el comportamiento de la página.
    • Ignorar los avisos: los avisos de key de React, de hidratación y de deprecación no son bugs, pero suelen anunciarlos.
    • Reenviar un 500 directamente al backend: el código dice que el servidor falló, pero al informe le faltan la URL, los nombres de parámetros y la acción. Sin esos tres, la respuesta siempre será «reprodúcelo».

    FAQ

    ¿Un error de sintaxis es un bug? En el código fuente normalmente no llega a producción: el build lo detecta. Si en producción aparece un SyntaxError, el problema está en la cadena de publicación —build sin validar o un CDN sirviendo un archivo antiguo— y se trata como defecto. ¿Hay que incluir los avisos de consola en el informe? Solo los relacionados con el síntoma. Página en blanco con aviso de hidratación sí; un aviso de deprecación de una librería no, porque entierra la pista real. ¿Un «API 500» es de front-end o de backend? Quién lo corrige depende de vuestro proceso, pero el contenido del informe es el mismo: URL, código de estado, acción, marca de tiempo y si se reproduce. Primero aclarad si el front-end envió mal los parámetros o si el servidor falló de verdad. ¿Por qué el desarrollador siempre dice «no lo puedo reproducir»? Porque lo que falta es un entorno, no unos pasos: permisos, volumen de datos, versión de navegador, zona horaria y feature flags cambian. Un campo de entorno en el informe elimina esa ronda. ¿Cómo consiguen compañeros no técnicos informes útiles? No les enseñes DevTools. Instala una extensión del navegador o incrusta un punto de entrada de feedback en el sitio, y deja que la herramienta recoja la consola y las peticiones fallidas: es la base de un sistema de feedback instantáneo.