Cad iad dearbhuithe i dtéacsáil?

Question

Accepted Answer

**Dearbhuithe** ná ráitis i dtéacs a **dhéanann seiceáil ar choinníoll ar leith a bheith fíor** — ag fíorú go bhfuil an toradh iarbhír ag teacht leis an toradh a bhí dúshlánaithe. Is iad an croílár an chaoi ar a chinneann tríalanna a rása nó a gclaontadh: más fhéidir dearbhú a theip, teipim ar an tríal.

## Cad a dhéanann dearbhuithe

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

## Gnáth-chineálacha dearbhuithe

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

## Dearbhuithe maithe

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

## Cén fáth a bhfuil sé tábhachtach

Tá tuiscint ar dhearbahuiteach bunúsach toisc gur iad **an córas croílár ar a laghad ag fíorú iompar** — ag cinneadh rása nó teip — agus is riachtanach, fios a bheith acu ar feadh scríobh aon tréal.

A **sheiceálaionn dearbhú go bhfuil coinníoll fíor** (go hiondúil go bhfuil toradh iarbhír ag teacht leis an gceann a bhí dúshlánaithe), agus is é an chuid "fíorúchán" de thríal: má théann dearbhú tríd an seiceáil, agus má theipim ar an tríal.

Gan dearbhuithe, ní dhéanann tríal fíorú ar rud ar bith i ndáiríre — agus dá sin de tá tuiscint orthu bunúsach ar scríobh trialacha atá ábhartha.

Tuiscint ar an **ghnáth-chineálacha dearbhuithe** — comhionannas (docht `toBe` i gcoinne domhain/luachanna `toEqual` do réada, idirdhealú tábhachtach), seiceálacha agus null, comparáidí, seiceálacha bailiúcháin agus sreang, dearbhuithe earráide (ag fíorú go gcaitheann feidhm), agus diúltú — is eolas praiticiúil riachtanach iad chun a chuir in iúl cad ba chóir a bhheith fíoraithe ag tríal.

Tuiscint ar **dhréachtaí maithe dearbhuithe** — ag dearbhú an toraidh sonrach dúshlánaithe (soiléir ar a bhfuil seicéilte), ag baint úsáide as an meaisíneoir ceart (m.sh. `toEqual` i gcomparáid réada, nach `toBe`), ag gealadh teachtaireachtaí claontadh soiléir (chun go míniú tríal teipthe conas a chuaigh sé mícheart), agus trialacha a bheirtiú — is éachtach léiriú ar thrialacha soiléir, éifeachtúla a scríobh.

Toisc go bhfuil dearbhuithe an dóigh ar a bhfíoraíonn gach tríal iompar (an tseiceáil bhunúsach a dhéanann tríal ábhartha) agus tuiscint orthu — na cineálacha, an meaisíneoir ceart, agus dréachtaí maithe — is gá chun aon tríal a scríobh a bhfíoraíonn rud, tá dearbhuithe tuiscint ar eolas bunúsach, alap tréalach — an bloc bunúsach a bhí i dtrialacha, gá chun iompar dúshlánaithe a chur in iúl agus a bhfíorú, agus bunúsach ar scríobh trialacha a dhéanann seiceáil ábhartha chothromaíochta, inniúlacht bhunúsach do dhuine ar bith a scríobh trialacha.