Actualizar una captura es una decisión de revisión.

Una comprobación visual falla después de desaparecer un botón. Actualizar la imagen esperada devuelve el verde, pero puede convertir la desaparición en la nueva normalidad. El comando no decide si debía desaparecer. Cambiar la referencia es una decisión sobre el producto, no una reparación de la herramienta.

Esta guía sigue la documentación de capturas de Playwright con una tarjeta local inventada. Comparamos una muestra sin cambios en un entorno controlado. No es una interfaz de producción, certificado de accesibilidad ni resultado de rendimiento. Queremos saber qué acepta la nueva referencia.

Nombra la referencia y el entorno

La aserción compara la captura con una referencia. La guía describe generarla en la primera ejecución y comparar después. El nombre debe identificar la vista, para que una imagen ajena no la sustituya.

await page.setContent(`
  <main aria-label="Demo preference card">
    <h1>Demo preference</h1>
    <button>Keep demo setting</button>
  </main>
`);
await expect(page.getByRole('main')).toHaveScreenshot('demo-card.png');

Se necesitan el ejecutor de Playwright y expect importado. Solo se captura una región, no todo el producto. La muestra usa estilo estable y ventana fija. Se crea deliberadamente la referencia y se compara en otra ejecución.

El renderizado puede variar con sistema, navegador, configuración, equipo o modo sin interfaz. Crea y compara en el mismo entorno. Otra plataforma puede necesitar otra referencia, no una tolerancia mayor que oculte un cambio importante.

Lee la diferencia antes de sustituirla

Inspecciona esperado, actual y cambio visible. Puede haber cambiado el requisito, el entorno o la aplicación por un defecto. Las causas exigen respuestas diferentes aunque produzcan el mismo rojo.

El comando update-snapshots está documentado. Úsalo después de comprender y aprobar el cambio según el proceso del equipo. Revisa los archivos resultantes como cambios de comportamiento esperado. No actualices todo solo para silenciar fallos.

Un botón eliminado puede ser un rediseño correcto o un defecto grave. Los píxeles no lo saben. Relaciona el cambio con el requisito y conserva una aserción funcional cuando importa la disponibilidad del control.

Delimita la comparación

Una región solo aporta evidencia de esa región y configuración. No inspecciona lo que queda fuera, otras ventanas ni resultados del servidor. Elige por la pregunta, no porque un recorte pequeño resulta más fácil.

La guía ofrece tolerancias y estilos específicos para capturas. Reducen ruido, pero cambian qué diferencias cuentan. Nombra elementos excluidos y tolerancias; nunca ocultes el control que quieres proteger.

Comparamos la tarjeta sin cambios y creamos otra imagen con texto de botón distinto para inspección. La segunda no se acepta como referencia. Esto muestra un cambio visible y una comparación estable, no una estrategia completa.

Conserva una decisión revisable

Registra vista, entorno, diferencia prevista y aceptación. Mantén el historial para explicar por qué cambió la expectativa. Evita registros privados antes de guardar imágenes en un repositorio.

AnyTest describe exploración y pruebas para revisión humana. Pregunta qué compara la propuesta y quién aprobó la expectativa. No se afirma una función de referencias de AnyTest. El comando escribe un archivo; el revisor decide su significado.