Ábrelas con F12 (o Ctrl+Shift+I, Cmd+Option+I en Mac). Los paneles principales son Elements, Console, Sources, Network, Performance, Memory y Application.
Breakpoints
En el panel Sources, haz clic en el número de una línea: el programa se detendrá ahí la próxima vez que llegue. Con el programa en pausa ves:
- Scope: todas las variables visibles, locales, de closures y globales, con su valor.
- Call Stack: la pila de llamadas, la misma de la sección 4. Haz clic en un marco para ver sus variables.
- Watch: expresiones que quieres vigilar mientras avanzas.
Y avanzas con los botones (o sus atajos):
| Botón | Hace |
|---|---|
| Resume (F8) | Sigue hasta el próximo breakpoint |
| Step over (F10) | Ejecuta la línea, sin entrar en las funciones que llama |
| Step into (F11) | Entra en la función que se llama en esta línea |
| Step out (Shift+F11) | Termina la función actual y vuelve a quien la llamó |
Más tipos de breakpoint:
- Condicional: clic derecho → Add conditional breakpoint; solo se detiene si la condición se cumple (
producto.id === 42). - Logpoint: imprime un mensaje en la consola sin detenerse y sin tocar el código.
- En excepciones: se detiene justo donde se lanza un error, incluso si alguien lo atrapa.
- En eventos, en el DOM o en peticiones: cuando ocurre un clic, cuando cambia un elemento, cuando se pide cierta URL.
La instrucción debugger; en el código hace lo mismo que un breakpoint (si las DevTools están abiertas).
Leer un error
Un error en la consola trae la pila de llamadas del momento: la primera línea dice dónde falló, y las siguientes, quién llamó a quién. El origen del problema muchas veces está más abajo en la pila: en los datos que alguien pasó.
Con los source maps, que generan Vite y los demás empaquetadores, las DevTools muestran tu código original (con TypeScript, sin minificar) aunque el navegador ejecute el empaquetado.
Red
El panel Network muestra cada petición: URL, método, estado, tamaño, tiempo, encabezados, el cuerpo enviado y la respuesta. Útil para:
- Ver si una petición falló (en rojo) y por qué: 404, 500, CORS.
- Comprobar qué datos se enviaron de verdad.
- Simular una conexión lenta (Throttling) o sin conexión.
- Copiar una petición como
curlo comofetchpara repetirla.
Rendimiento
El panel Performance graba lo que hace la página durante unos segundos: cada función, cada dibujo, cada tarea. Las tareas largas (más de 50 ms) aparecen marcadas: son las que traban la página. En la vista Bottom-Up ves qué funciones consumieron más tiempo. Puedes marcar tus propios tramos con performance.mark y performance.measure, que aparecen en la grabación.
El panel Lighthouse (o PageSpeed Insights) mide la página entera: velocidad de carga, accesibilidad, buenas prácticas.
Memoria
Si la memoria de la página crece sin parar, hay una fuga. En el panel Memory:
- Toma un heap snapshot.
- Repite la acción sospechosa (abrir y cerrar un diálogo varias veces).
- Toma otro y compáralos (Comparison): busca objetos que crecieron y deberían haberse liberado, y mira qué los retiene (Retainers).
Las causas típicas las viste en Memoria y recolector de basura: listeners sin quitar, temporizadores, cachés que crecen, elementos del DOM retirados que alguien sigue guardando.
Node.js con las mismas herramientas
node --inspect servidor.js # abre el depurador
node --inspect-brk script.js # y se detiene en la primera línea
Después, en Chrome, abre chrome://inspect y elige el proceso: tienes Sources, Console, Performance y Memory para tu programa de Node. Los editores como VS Code se conectan a lo mismo y te dejan poner breakpoints directamente en el código.
Resumen
- Breakpoints (normales, condicionales, en excepciones) y logpoints en el panel Sources;
debugger;en el código. - En pausa: Scope (variables), Call Stack (la pila) y Watch; avanza con step over, into y out.
- La pila de un error se lee de arriba abajo; la causa suele estar más abajo.
- Network para las peticiones; Performance para las tareas largas; Memory para las fugas.
node --inspectychrome://inspectdepuran Node.js con las mismas herramientas.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Encontrar el error
Resuelto
Elige una respuesta en cada pregunta.
¿Qué ventaja tiene un breakpoint sobre llenar el código de
console.log?¿Qué hace la instrucción
debugger;en el código?Para encontrar una fuga de memoria, ¿qué se usa?
¿Para qué sirve el panel Performance?
Ordena la salida: Medir con marcas
Resuelto
Marcas de rendimiento alrededor de un bucle. Ordena lo que aparecería en la consola.
1performance.mark("inicio");2let suma = 0;3for (let i = 0; i < 1e5; i++) suma += i;4performance.mark("fin");5 6const medida = performance.measure("bucle", "inicio", "fin");7console.log(medida.name);8console.log(medida.duration >= 0);9console.log(performance.getEntriesByType("mark").map((m) => m.name).join(","));10console.log(suma);Consola, de arriba abajo
- inicio,fin
- bucle
- 4999950000
- true
Las marcas y medidas de performance aparecen también en el panel Performance de las DevTools, en su propia pista. Así ves cuánto tarda tu código dentro de la grabación de todo lo demás.
Detective: Leer la pila del error
Resuelto
Lee la pila de llamadas del error para encontrar dónde empezó el problema, que no es donde salta.
Consola
Uncaught TypeError: Cannot read properties of undefined (reading 'toUpperCase')
at formatear (lista.js:2:26)
at Array.map (<anonymous>)
at renderizarLista (lista.js:6:20)
at lista.js:9:1Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?