¿Qué son las aserciones en las pruebas?

Question

Accepted Answer

**Aserciones** son sentencias en una prueba que **verifican si una condición es verdadera** — comprobando que el resultado real coincide con el resultado esperado. Son el núcleo de cómo las pruebas determinan éxito o fracaso: si una aserción falla, la prueba falla.

## Qué hacen las aserciones

```text
An ASSERTION checks that something is as expected:
  → "assert that the actual value EQUALS the expected value"
  → if TRUE → the assertion passes; if FALSE → the assertion FAILS → the TEST FAILS
→ Assertions are how a test VERIFIES behavior (the "check" part of a test).
```

## Tipos comunes de aserciones

```js
// equality
expect(result).toBe(5);                  // strict equality
expect(obj).toEqual({ name: 'Ann' });    // deep/value equality (objects)

// truthiness / null
expect(value).toBeTruthy();
expect(value).toBeNull();
expect(value).toBeDefined();

// comparisons
expect(count).toBeGreaterThan(0);
expect(price).toBeLessThanOrEqual(100);

// collections / strings
expect(array).toContain('item');
expect(array).toHaveLength(3);
expect(text).toMatch(/pattern/);          // regex

// errors
expect(() => risky()).toThrow();          // expect a function to throw

// negation
expect(value).not.toBe(null);
```

## Buenas aserciones

```text
✓ Assert the SPECIFIC expected outcome (clear what's being checked)
✓ Use the RIGHT matcher (toBe vs toEqual; specific > generic)
✓ Clear FAILURE messages (good assertions/matchers explain what failed)
✓ Don't over-assert (test one behavior) or under-assert (verify the actual result)
```

## Por qué es importante

Entender las aserciones es fundamental porque son **el mecanismo central mediante el cual las pruebas verifican el comportamiento** — determinando éxito o fracaso — por lo que es conocimiento esencial e imprescindible para escribir cualquier prueba.

Una aserción **verifica que una condición sea verdadera** (típicamente que un resultado real coincida con uno esperado), y es la parte de "verificación" de una prueba: si una aserción pasa la verificación se cumple, y si falla la prueba falla.

Sin aserciones, una prueba no verifica realmente nada — así que entenderlas es fundamental para escribir pruebas significativas.

Entender los **tipos comunes de aserciones** — igualdad (strict `toBe` vs profunda/valor `toEqual` para objetos, una distinción importante), verificaciones de veracidad y nulidad, comparaciones, verificaciones de colecciones y cadenas, aserciones de error (verificando que una función lanza excepción), y negación — es conocimiento práctico necesario para expresar qué debe verificar una prueba.

Entender las **buenas prácticas de aserciones** — verificar el resultado esperado específico (siendo claro sobre qué se comprueba), usar el matcher correcto (p. ej. `toEqual` para comparación de objetos, no `toBe`), asegurar mensajes de fracaso claros (para que una prueba fallida explique qué salió mal), y balancear aserciones (probando un comportamiento, pero verificando el resultado real) — refleja escribir pruebas claras y efectivas.

Puesto que las aserciones son cómo cada prueba verifica comportamiento (la verificación fundamental que hace una prueba significativa) y entenderlas — los tipos, los matchers correctos, y buenas prácticas — es necesario para escribir cualquier prueba que realmente verifique algo, entender aserciones es conocimiento de pruebas esencial y fundamental — el bloque de construcción central de las pruebas, necesario para expresar y verificar comportamiento esperado, y fundamental para escribir pruebas que verifiquen significativamente la corrección, una competencia básica para cualquiera que escriba pruebas.