¿Qué son las pruebas de instantáneas (snapshot testing)?

Question

Accepted Answer

Las **pruebas de instantáneas** (snapshot testing) capturan una "instantánea" de alguna salida (habitualmente el resultado renderizado de un componente de UI o una estructura de datos) y comparan las ejecuciones futuras con ella, señalando cuándo cambia la salida. Son útiles para detectar cambios no intencionados, pero tienen limitaciones que conviene comprender.

## Cómo funcionan las pruebas de instantáneas

```text
1. First run → the test RECORDS the output (e.g. a rendered component) as a SNAPSHOT file
2. Later runs → COMPARE the current output to the saved snapshot:
   → MATCHES → pass; DIFFERS → fail (the output changed)
3. If the change is INTENTIONAL → UPDATE the snapshot (review the diff, then accept)
```

```js
// Jest snapshot test (e.g. a React component)
test('renders correctly', () => {
  const tree = render(<Button label="Click" />).toJSON();
  expect(tree).toMatchSnapshot();    // compares to the stored snapshot
});
```

## Usos y beneficios

```text
✓ Detect UNINTENDED CHANGES — flags when output changes unexpectedly (UI, serialized data)
✓ FAST to write — no manual assertions for complex output; auto-captures the expected result
✓ Good for UI components (catch unexpected rendering changes), config, large data structures
```

## Limitaciones (usar con cuidado)

```text
⚠️ Snapshots don't verify CORRECTNESS — they capture whatever output exists (even if WRONG);
   they only detect CHANGE, not that the output is RIGHT
⚠️ BLINDLY UPDATING snapshots (jest -u without reviewing) → defeats the purpose (accepting
   broken output) — a common bad habit
⚠️ Large/brittle snapshots → change often, get rubber-stamped, low value
→ Use for change detection; keep snapshots small/focused; REVIEW snapshot diffs;
  don't rely on them alone (combine with real assertions for behavior).
```

## Por qué es importante

Comprender las pruebas de instantáneas es valioso porque es una **técnica de uso común** (especialmente para UI) que resulta útil cuando se aplica bien pero problemática cuando se usa mal, por lo que entender tanto su valor como sus limitaciones es un conocimiento práctico importante.

Las pruebas de instantáneas — capturar la salida (habitualmente un componente de UI renderizado o una estructura de datos) y comparar las ejecuciones futuras con la instantánea almacenada — son **útiles para detectar cambios no intencionados**: señalan cuándo cambia la salida de forma inesperada (detectando cambios accidentales en el renderizado de la UI o en las estructuras de datos), son **rápidas de escribir** (capturando automáticamente la salida esperada sin afirmar manualmente cada detalle de una salida compleja) y se adaptan bien a componentes de UI, configuración y estructuras de datos grandes.

Comprender estos beneficios explica su popularidad, especialmente en las pruebas de UI.

Sin embargo, comprender las **limitaciones es de importancia crítica** para usarlas bien: las instantáneas **no verifican la corrección** — capturan cualquier salida que exista (incluso si es incorrecta), detectando únicamente el *cambio* y no la *corrección* — por lo que una instantánea puede fijar una salida defectuosa.

El **mayor riesgo es actualizar las instantáneas a ciegas** (ejecutar el comando de actualización sin revisar el diff), lo que desvirtúa su propósito al aceptar una salida potencialmente defectuosa — un mal hábito común.

Las instantáneas grandes y frágiles que cambian con frecuencia acaban aprobándose mecánicamente y aportan poco valor.

Comprender el uso adecuado — para la detección de cambios, manteniendo las instantáneas pequeñas y enfocadas, **revisando los diffs de las instantáneas** con cuidado y no dependiendo solo de ellas (combinándolas con afirmaciones reales de comportamiento) — refleja un criterio maduro que evita el mal uso habitual.

Dado que las pruebas de instantáneas se usan ampliamente (especialmente para UI) y son útiles para la detección de cambios pero se prestan fácilmente al mal uso (fijar una salida incorrecta, actualizar a ciegas), y dado que comprender tanto su valor como sus importantes limitaciones permite usarlas bien, entender las pruebas de instantáneas es un conocimiento valioso y prácticamente relevante — una técnica común que conviene comprender correctamente, donde apreciar sus limitaciones (detección de cambios, no de corrección) y su uso adecuado (revisar diffs, no actualizar a ciegas) es tan importante como la técnica misma, lo que refleja un buen criterio en las pruebas.