Vitest 5: depuración paso a paso de tests de navegador con Trace ViewArtículo · digest del 23 de octubre
Línea temporal interactiva de Trace View en el navegador con instantáneas paso a paso del DOM y el marco resaltado del elemento donde falló el test.
Artículo3 secciones≈ 5 min

Vitest 5: depuración paso a paso de tests de navegador con Trace View

Cualquiera que haya configurado alguna vez tests end-to-end o de componentes en un navegador real conoce esa sensación de impotencia. El pipeline de CI se tiñe de rojo alarmante. Abres los artefactos de la build, buscas la captura de pantalla tomada justo al fallar el test y te encuentras... una página en blanco o una ventana modal ya cerrada.

Para cuando el assertion lanzó el error de timeout, la interfaz ya había cambiado: la animación terminó, la notificación flotante se esfumó y el formulario volvió a su estado inicial. Al desarrollador no le queda otra que lanzar el test en local, meter pausas artificiales con await sleep(5000) e ir sembrando breakpoints en el depurador para cazar un estado que se escapa entre los dedos.

En la versión mayor Vitest 5, el equipo del proyecto ha dado un golpe certero a ese problema. El modo de ejecución en navegador real (Browser Mode) estrena ahora una herramienta interactiva de depuración paso a paso: Trace View.

Ya veníamos siguiendo cómo avanzan las herramientas del ecosistema Vite y VoidZero para unir build y testing en un único flujo rápido. Este nuevo sistema de trazado en Vitest 5 hace que trabajar con tests de navegador sea igual de transparente y predecible.

Serialización del DOM en lugar de vídeo pesado

La gran idea de ingeniería detrás de Trace View es prescindir de grabar flujos continuos de vídeo o capturas aisladas. En su lugar, Vitest toma instantáneas digitales ligeras del árbol de elementos en cada momento clave:

  • En cada acción del usuario (clic en un botón, escritura en un input, paso del ratón);
  • En cada llamada de comprobación de estado (expect(...));
  • En cada marca de control añadida a mano con page.mark().

Esas instantáneas son estructuras serializadas del DOM muy ligeras, que se comprimen y guardan en orden cronológico. El resultado es una auténtica «máquina del tiempo» para el test: haces clic en cualquier punto de la línea temporal y ves exactamente la página tal como estaba en el navegador en ese preciso milisegundo.

Dónde y cómo funciona el visor interactivo

No hace falta instalar programas pesados aparte. El visor de trazas viene integrado en los entornos habituales de trabajo:

  1. Directamente en el navegador: al lanzar tests en local con ventana abierta, el panel de Trace View aparece junto al componente bajo prueba.
  2. En la interfaz gráfica Vitest UI: una línea temporal cómoda te deja moverte paso a paso con las flechas del teclado.
  3. En la extensión oficial para VS Code: al hacer clic en el paso fallido desde el panel de testing, el editor salta y resalta de inmediato la línea problemática en tu código.
  4. En informes HTML estáticos autónomos: el servidor de CI puede generar un único archivo HTML de la build. Cualquier QA o desarrollador lo abre en su navegador local sin levantar contenedores ni recompilar el proyecto.

Al colocarte sobre un paso concreto, el elemento que falló queda enmarcado con un borde de alto contraste y el stack de llamadas muestra con total claridad qué expectativa no se cumplió.

// vitest.config.ts — activación de Trace View en Browser Mode
import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    browser: {
      enabled: true,
      name: 'chromium',
      provider: 'playwright', // o 'webdriverio'
      traceView: true,
      headless: true,
    },
  },
});

Una ventaja clave de la implementación en Vitest es su total independencia del driver de navegador. Funciona igual sobre Playwright, WebDriverIO o proveedores de vista previa, sin exigir utilidades propietarias de línea de comandos.

// tests/checkout.test.ts — ejemplo de escenario con registro de pasos
import { test, expect } from 'vitest';
import { page } from '@vitest/browser/context';

test('оформление заказа с валидацией промокода', async () => {
  const promoInput = page.getByRole('textbox', { name: 'Промокод' });
  await promoInput.fill('SALE2026');

  const applyBtn = page.getByRole('button', { name: 'Применить' });
  await applyBtn.click();

  // Si falla esta aserción, Trace View mostrará el estado del DOM justo al hacer clic
  const discountLabel = page.getByTestId('discount-amount');
  await expect.element(discountLabel).toHaveText('-20%');
});
Ahorro de recursos en suites de tests grandes

Grabar instantáneas del DOM paso a paso consume inevitablemente algo más de memoria RAM. En monorepositorios grandes con miles de tests en CI/CD, conviene activar el guardado solo para los casos que fallen (traceView: 'on-failure') para no inflar los artefactos de compilación.

Conclusión práctica

Trace View en Vitest 5 saca la depuración de tests de navegador del terreno de la adivinación con console.log y la convierte en diagnóstico de ingeniería preciso. Poder reconstruir en dos clics el contexto exacto de un fallo desde el propio informe del CI ahorra horas enteras y deja que los equipos de frontend se concentren en construir interfaces fiables.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2