Czym są asercje w testowaniu?

Question

Accepted Answer

**Asercje** to instrukcje w teście, które **sprawdzają, czy warunek jest prawdziwy** — weryfikując, że rzeczywisty wynik odpowiada oczekiwanemu wynikowi. Stanowią rdzeń sposobu, w jaki testy określają powodzenie lub porażkę: jeśli asercja się nie powiedzie, test się nie powiedzie.

## Co robią asercje

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

## Typowe rodzaje asercji

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

## Dobre asercje

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

## Dlaczego to ważne

Rozumienie asercji jest fundamentalne, ponieważ są to **główny mechanizm, przez który testy weryfikują zachowanie** — określając powodzenie lub porażkę — więc jest to niezbędna, obowiązkowa wiedza do pisania jakiegokolwiek testu.

Asercja **sprawdza, czy warunek jest prawdziwy** (zazwyczaj że rzeczywisty wynik odpowiada oczekiwanemu), i stanowi część "weryfikacji" testu: jeśli asercja przechodzi, sprawdzenie się powiodło, a jeśli się nie powiedzie, test się nie powiedzie.

Bez asercji test w ogóle niczego nie weryfikuje — więc rozumienie ich jest fundamentalne do pisania znaczących testów.

Rozumienie **typowych rodzajów asercji** — równości (ścisłe `toBe` vs głębokie/wartościowe `toEqual` dla obiektów, ważne rozróżnienie), sprawdzenia wartości logicznych i wartości null, porównania, sprawdzenia kolekcji i stringów, asercje błędów (weryfikacja, czy funkcja zgłasza wyjątek), oraz negacja — jest niezbędną praktyczną wiedzą do wyrażania tego, co test powinien weryfikować.

Rozumienie **dobrych praktyk asercji** — sprawdzanie konkretnego oczekiwanego wyniku (jasne, co jest sprawdzane), użycie właściwego matchera (np. `toEqual` do porównania obiektów, a nie `toBe`), zapewnienie jasnych komunikatów o błędach (aby test, który się nie powiedzie, wyjaśniał, co poszło nie tak), oraz balansowanie asercji (testowanie jednego zachowania, ale weryfikacja rzeczywistego wyniku) — odzwierciedla pisanie jasnych, efektywnych testów.

Ponieważ asercje to sposób, w jaki każdy test weryfikuje zachowanie (fundamentalna kontrola, która czyni test znaczący) i rozumienie ich — rodzajów, właściwych matcherów i dobrych praktyk — jest niezbędne do pisania jakiegokolwiek testu, który coś faktycznie weryfikuje, rozumienie asercji jest zasadniczą, fundamentalną wiedzą z zakresu testowania — podstawowym klockiem testów, niezbędnym do wyrażania i weryfikacji oczekiwanego zachowania, oraz fundamentalne dla pisania testów, które w znaczący sposób sprawdzają poprawność, podstawową kompetencją dla każdego piszącego testy.