Cosa sono le asserzioni nei test?

Question

Accepted Answer

**Le asserzioni** sono istruzioni in un test che **verificano se una condizione è vera** — controllando che il risultato effettivo corrisponda al risultato atteso. Sono il nucleo di come i test determinano il successo o il fallimento: se un'asserzione fallisce, il test fallisce.

## Cosa fanno le asserzioni

```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).
```

## Tipi comuni di asserzioni

```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);
```

## Buone asserzioni

```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)
```

## Perché è importante

Comprendere le asserzioni è fondamentale perché sono **il meccanismo centrale attraverso cui i test verificano il comportamento** — determinando il successo o il fallimento — quindi è una conoscenza essenziale e imprescindibile per scrivere qualsiasi test.

Un'asserzione **verifica che una condizione sia vera** (tipicamente che un risultato effettivo corrisponda a uno atteso), ed è la parte di "verifica" di un test: se un'asserzione passa il controllo è soddisfatto, e se fallisce il test fallisce.

Senza asserzioni, un test non verifica effettivamente nulla — quindi comprendere le asserzioni è fondamentale per scrivere test significativi.

Comprendere i **tipi comuni di asserzioni** — uguaglianza (strict `toBe` vs deep/value `toEqual` per oggetti, una distinzione importante), controlli di veridicità e null, confronti, controlli su collezioni e stringhe, asserzioni di errore (verificare che una funzione lanci un'eccezione), e negazione — è una conoscenza pratica necessaria per esprimere cosa un test deve verificare.

Comprendere le **buone pratiche di asserzione** — asserire il risultato atteso specifico (essere chiari su cosa viene controllato), usare il matcher giusto (ad es. `toEqual` per il confronto di oggetti, non `toBe`), garantire messaggi di fallimento chiari (così un test che fallisce spiega cosa è andato male), e bilanciare le asserzioni (testare un comportamento, ma verificare il risultato effettivo) — riflette la scrittura di test chiari ed efficaci.

Poiché le asserzioni sono come ogni test verifica il comportamento (il controllo fondamentale che rende un test significativo) e comprendere le asserzioni — i tipi, i matcher giusti, e le buone pratiche — è necessario per scrivere qualsiasi test che verifichi effettivamente qualcosa, comprendere le asserzioni è una conoscenza di test essenziale e fondamentale — il blocco di costruzione centrale dei test, necessario per esprimere e verificare il comportamento atteso, e fondamentale per scrivere test che controllino in modo significativo la correttezza, una competenza di base per chiunque scriva test.