Apakah itu assertions dalam pengujian?

Question

Accepted Answer

**Assertions** ialah pernyataan dalam ujian yang **memeriksa sama ada sesuatu syarat benar** — mengesahkan bahawa hasil sebenar sepadan dengan hasil yang dijangka. Ia merupakan teras kepada bagaimana ujian menentukan lulus atau gagal: jika sesuatu assertion gagal, ujian itu gagal.

## Apa yang dilakukan oleh 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).
```

## Jenis assertion biasa

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

## Assertion yang baik

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

## Mengapa ia penting

Memahami assertions adalah asas kerana ia merupakan **mekanisme teras yang digunakan oleh ujian untuk mengesahkan tingkah laku** — menentukan lulus atau gagal — jadi ia merupakan pengetahuan penting yang mesti diketahui untuk menulis sebarang ujian.

Satu assertion **memeriksa bahawa sesuatu syarat benar** (biasanya bahawa hasil sebenar sepadan dengan yang dijangka), dan ia merupakan bahagian "pengesahan" sesuatu ujian: jika sesuatu assertion lulus maka semakan itu sah, dan jika ia gagal maka ujian itu gagal.

Tanpa assertions, sesuatu ujian sebenarnya tidak mengesahkan apa-apa — jadi memahaminya adalah asas kepada penulisan ujian yang bermakna.

Memahami **jenis assertion biasa** — equality (strict `toBe` vs deep/value `toEqual` untuk objek, satu perbezaan penting), semakan truthiness dan null, comparisons, semakan collection dan string, error assertions (mengesahkan sesuatu function throw), dan negation — adalah pengetahuan praktikal yang perlu untuk menyatakan apa yang sepatutnya disahkan oleh sesuatu ujian.

Memahami **amalan assertion yang baik** — menegaskan hasil spesifik yang dijangka (jelas tentang apa yang disemak), menggunakan matcher yang betul (cth. `toEqual` untuk perbandingan objek, bukan `toBe`), memastikan mesej kegagalan yang jelas (supaya ujian yang gagal menerangkan apa yang tidak kena), dan mengimbangi assertion (menguji satu tingkah laku, tetapi mengesahkan hasil sebenar) — mencerminkan penulisan ujian yang jelas dan berkesan.

Memandangkan assertions ialah cara setiap ujian mengesahkan tingkah laku (semakan asas yang menjadikan ujian bermakna) dan memahaminya — jenis-jenisnya, matcher yang betul, dan amalan yang baik — adalah perlu untuk menulis sebarang ujian yang benar-benar mengesahkan sesuatu, memahami assertions adalah pengetahuan pengujian asas yang penting — blok binaan teras ujian, perlu untuk menyatakan dan mengesahkan tingkah laku yang dijangka, dan asas kepada penulisan ujian yang menyemak ketepatan dengan bermakna, satu kecekapan asas bagi sesiapa yang menulis ujian.