Kas yra testų patvirtinimai (assertion)?

Question

Accepted Answer

**Patvirtinimai** yra testų sakiniai, kurie **tikrina, ar sąlyga yra teisinga** — patvirtina, kad faktinis rezultatas atitinka tikėtinąjį rezultatą. Jie yra pagrindinė testų dalis, nustatanti, ar testas praėjo ar nepraėjo: jei patvirtinimas nepavyksta, testas nepavyksta.

## Ką patvirtinimai daro

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

## Dažniausiai pasitaikantys patvirtinimų tipai

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

## Geri patvirtinimai

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

## Kodėl tai svarbu

Supratimas apie patvirtinimus yra žinomina, nes jie yra **pagrindinė sistemo dalis, per kurią testai patvirtina veikimą** — nustatydami, ar testas praėjo ar nepraėjo — todėl tai yra neatsiejama, būtina žinoti medžiaga bet kokiam testui rašyti.

Patvirtinimas **tikrina, ar sąlyga yra teisinga** (paprastai patikrinant, ar faktinis rezultatas atitinka tikėtinąjį), ir jis yra „verifikavimo" dalis: jei patvirtinimas praeina, sąlyga galioja, o jei nepavyksta – testas nepavyksta.

Be patvirtinimų, testas iš tikrųjų nieko nepatvirtina – todėl jų supratimas yra žinominas norint rašyti prasmingus testus.

Supratimas apie **dažniausiai pasitaikančius patvirtinimų tipus** — lygybę (griežta `toBe` prieš giliąją/reikšmės `toEqual` objektams, svarbus skirtumas), teisingumą ir null tikrinimus, palyginimus, rinkinių ir eilučių tikrinimus, klaidų patvirtinimus (patvirtinant, kad funkcija meta klaidą) ir neigimą – yra būtina praktinė žinoma testui nustatyti, ką jis turi patvirtinti.

Supratimas apie **gerus patvirtinimo praktiką** — patvirtinant konkretų tikėtinąjį rezultatą (aiškiai nurodant, kas tikrinama), naudojant tinkamą matcher'į (pvz., `toEqual` objektų palyginimui, o ne `toBe`), užtikrinant aiškias klaidų žinutes (kad nepavykęs testas paaiškintų, kas nutiko) ir subalansuojant patvirtinimus (testuojant vieną veikimą, bet patvirtinant faktinį rezultatą) – atspindi aiškių, veiksmingų testų rašymą.

Del to, kad patvirtinimai yra tai, kaip kiekvienas testas patvirtina veikimą (pagrindinis patikrinimas, kuris padarytestą prasminingu) ir supratimas apie juos – jų tipai, tinkamų matcher'ių naudojimas ir gera praktika – yra būtinas bet kurio testo, kuris iš tikrųjų patvirtina ką nors, parašymui, patvirtinimų supratimas yra neatsiejama, pagrindinė testų žinoma – pagrindinė testų dalis, būtina norint išreikšti ir patvirtinti tikėtiną veikimą, ir žinomina šios žinomybės sprendimui, pagrindiniam gebėjimui visiems, kurie rašo testus.