X'inhu l-assertions fit-testing?

Question

Accepted Answer

**Assertions** huma statements fi test li **jivverifikaw jekk kundizzjoni hija vera** — jiċċekkjaw li r-riżultat attwali jaqbel mar-riżultat mistennija. Huma l-qalba ta' kif it-tests jiddeterminaw pass jew fail: jekk assertion ifalli, it-test ifalli.

## X'jagħmlu l-assertions

```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 ta' assertions komuni

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

## Assertions tajjeb

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

## Għaliex hija importanti

L-għarfien ta' assertions huwa fundamentali għax huma **l-mekkaniżmu essenzjali li bih it-tests jivverifikaw il-peħpeħ** — jiddeterminaw pass jew fail — għalhekk huwa essenzjali, għarfien li għandek taf, għall-kitba ta' kwalsidir test.

Assertion **jivverifika li kundizzjoni hija vera** (tipikament li riżultat attwali jaqbel ma' wieħed mistennija), u hija l-parti tal-"verifikazzjoni" ta' test: jekk assertion tgħaddi ċ-ċekk iżżomm, u jekk ifalli t-test ifalli.

Bla assertions, test ma jivverifikax xejn attwalment — għalhekk l-għarfien tagħhom huwa fundamentali għall-kitba ta' tests li joffru verament valur.

L-għarfien tal-**tipi ta' assertions komuni** — l-ugwaljanza (strict `toBe` versus deep/value `toEqual` għal oġġetti, distinzjoni importanti), tivverifiki tal-verità u null, komparazzjonijiet, ċekks ta' kollezioni u stringi, error assertions (jiċċekkja li funzjoni titfa' żbalji), u negazzjoni — huwa għarfien prattiku neċessarju għall-espressjoni ta' dak li test għandu jivverifika.

L-għarfien ta' **prattiki ta' assertions tajjeb** — assertions tal-ħruġ speċifiku mistennija (ċar dwar dak li ċċekka), l-użu tal-matcher it-tajjeb (eż. `toEqual` għal komparazzjoni ta' oġġetti, mhux `toBe`), i ċ-ċertezza ta' messaġġi ta' falliment ċari (sabiex test li jfalli jispjega x'mar ħażin), u bilanċ ta' assertions (testaħ behaviour wieħed, iżda tivverifika r-riżultat attwali) — jirrifletti l-kitba ta' tests ċari u effettivi.

Għax assertions huma kif kull test jivverifikaw il-peħpeħ (iċ-ċekk fundamentali li jagħmlu test sinifikanti) u l-għarfien tagħhom — it-tipi, il-matchers it-tajbin, u prattiki tajjeb — huwa neċessarju biex tikteb kwalsidir test li attwalment jivverifika xi ħaġa, l-għarfien ta' assertions huwa għarfien essenzjali, fundamentali tat-testing — il-blokk ta' binja essenzjali tat-tests, neċessarju għall-espressjoni u l-verifikazzjoni ta' behavior mistennija, u fundamentali għall-kitba ta' tests li jimmekkaniċċament iċċekkjaw il-korrezzjoni, kompetenza bażika għal ħadd li jikteb tests.