Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Tástáil Aonaid agus Comhtháthaithe Uathoibrithe

Ceacht 7 as 20 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Uathoibriú ar Scríobh Tástála
  2. Tástálacha Aonaid a Ghiniúint
  3. Tástálacha Comhtháthaithe a Ghiniúint
  4. Clúdach ar Thionscadal Iomlán
  5. Tástálacha Atá Ann Cheana a Fheabhsú
  6. Tástálacha de réir Cineáil Comhpháirte
  7. AGENTS.md a Chumrú do Thástálacha
  8. Príomhphointí

Uathoibriú ar Scríobh Tástála

Is iad na tástálacha an chéad rud a ghearrtar nuair a bhíonn an t-am gann, agus is iad an fiach is costasaí ina dhiaidh sin. Athraíonn Codex an chothromaíocht: is cúrsa nóiméad, seachas tráthnóna, é clúdach iomlán a ghiniúint do mhodúl. Ach caithfidh tú iarracht níos mó ná “scríobh tástálacha”, treoir a thugann handa cásanna ainmniúla—glas, suaimhneach, agus gan fiúntas.

Tástálacha Aonaid a Ghiniúint

Is é an príomhghiuirléid ná na cásanna imeallaigh a ainmniú duit féin. Is eol duit do cheantar gnó; níl a fhios ag an ngníomhaire go dtarlaíonn lascaine níos mó ná 100% uair sa ráithe i do chuid sonraí.

"Generate unit tests for src/lib/pricing.ts. 
Use Vitest. Cover all edge cases: negative price, 
discount > 100%, invalid currency, zero quantity."

Déanann Codex anailís ar an gcód foinse, aithníonn sé feidhmeanna onnmhairithe, tuigeann sé a lóic, agus ansin táirgeann sé sraith a chlúdaíonn bealaí normálta agus na cásanna a luaigh tú.

// src/lib/pricing.test.ts
import { describe, it, expect } from "vitest";
import { calculatePrice, applyDiscount, formatPrice } from "./pricing";

describe("calculatePrice", () => {
  it("calculates total price for a positive quantity", () => {
    expect(calculatePrice(10, 3)).toBe(30);
  });

  it("returns 0 for a quantity of zero", () => {
    expect(calculatePrice(10, 0)).toBe(0);
  });

  it("throws an error for a negative price", () => {
    expect(() => calculatePrice(-5, 1)).toThrow("Invalid price");
  });
});

describe("applyDiscount", () => {
  it("applies a standard discount", () => {
    expect(applyDiscount(100, 20)).toBe(80);
  });

  it("rejects a discount greater than 100%", () => {
    expect(() => applyDiscount(100, 150)).toThrow();
  });
});

Is fiú breathnú ar mhionsonra amháin: tógadh an teachtaireacht earráide a bhí ag súil léi, “Invalid price”, ón gcur chun feidhme iarbhír, níor cumadh í. Is é seo comhartha tástála a scríobhadh ón gcód seachas ó theimpléad, agus is é an chéad rud le seiceáil agus tú ag athbhreithniú ar shraith ghinte.

Tástálacha Comhtháthaithe a Ghiniúint

I gcás bealaigh API nó seirbhíse a bhaineann leis an mbunachar sonraí, ní mór duit níos mó comhthéacs a sholáthar, go háirithe maidir leis an méid atá le bréagú (mock).

"Generate integration tests for src/api/routes/orders.ts.
Use supertest for HTTP requests. Mock the Stripe 
service with vi.mock. Test scenarios: order creation, 
order with non-existent product, failed payment."

Déanann Codex idirdhealú soiléir idir an dá leibhéal tástála: cumraíonn sé bréagáin (mocks) iomchuí, láimhseálann sé socruithe agus díshocruithe bunachair sonraí tástála, agus déanann sé samhaltú ar sheirbhísí seachtracha. Coscann ainmniú Stripe agus supertest go sainráite air bonneagar comhthreomhar a chumadh ar rud a úsáideann d’fhoireann cheana féin.

Clúdach ar Thionscadal Iomlán

Ar thionscadal nach bhfuil tástálacha ann go struchtúrtha, tá tasc domhanda níos éifeachtaí ná sraith iarratas comhad ar chomhad.

"Analyze all .ts files in src/lib/ and src/services/. 
For each file without a corresponding .test.ts file, 
generate unit tests. Aim for branch coverage > 80%."

Ansin próiseálann Codex na comhaid ceann ar cheann, ag oiriúnú tástálacha do gach modúl; bíodh súil agat le roinnt nóiméad feidhmithe do shraith iomlán. Rith an tasc seo ar fhillteán amháin in aghaidh na huaire seachas ar an eolaire src/ iomlán: thairis sin, beidh an t-iarratas tarraingthe (pull request) ró-mhór le hathbhreithniú, agus ní chosnaíonn sraith tástála a formheasadh gan í a léamh aon duine.

Tástálacha Atá Ann Cheana a Fheabhsú

Ní chruthaíonn Codex amháin; is féidir leis sraith a dhiagnóisiú a thugann suaimhneas gan cosaint a thabhairt.

"Analyze tests in src/__tests__/. Identify:
- Tests that check only one path (happy path)
- Vague assertions (toBeTruthy instead of toBe)
- Tests that share mutable state
Fix these issues."

Míníonn na trí chomhartha seo formhór na sraitheanna glasa a ligeann do fhabhtanna dul tríd. Is é an tríú ceann an ceann is insidious: ritheann tástálacha a roinneann stát inathraithe chomh fada agus a ritheann siad san ord gnáth, agus tosaíonn siad ag teipthe go randamach an lá a chumasaíonn tú comhthreomhaireacht.

Tástálacha de réir Cineáil Comhpháirte

Braitheann an cineál tástála le hiarradh go díreach ar nádúr an chóid, agus athraíonn an treoir dá réir.

Cineál CóidCineál TástálaTreoir Codex
Feidhm úsáideAonad”Test all possible inputs and outputs”
Bealach APIComhtháthú”Test with supertest, mock external services”
Comhpháirt ReactRindreáil”Test rendering and interactions with Testing Library”
Seirbhís le DBComhtháthú”Use a test DB, reset between each test”

AGENTS.md a Chumrú do Thástálacha

In ionad na roghanna seo a athrá do gach tasc, scríobh iad uair amháin agus go deo i rannóg tiomnaithe de AGENTS.md.

## Tests
- Framework: Vitest
- Command: `npm run test`
- Coverage: `npm run test:coverage`
- Convention: .test.ts files next to source code
- Mocks: use vi.mock(), no manual mocks
- Assertions: prefer toBe/toEqual over toBeTruthy/toBeFalsy
- Each test must be independent (no shared state)

Leis na seacht líne seo, cuireann Codex do choinbhinsiúin i bhfeidhm ar gach tástáil a ghineann sé, fiú nuair a fhrásaíonn forbróir atá faoi bhrú a n-iarratas i dtrí fhocal. Is é seo an bealach is eacnamaí chun cáilíocht do thástála a dhéanamh neamhspleách ar cháilíocht na treorach.

Príomhphointí

  • Gineann Codex tástálacha oiriúnaithe do do chód, ní tástálacha ginearálta
  • Sonraigh na cásanna imeallacha ba mhaith leat a chlúdach i do threoracha
  • Déanann Codex idirdhealú idir tástálacha aonaid agus tástálacha comhtháthaithe
  • Úsáid AGENTS.md chun do choinbhinsiúin tástála a shainiú
  • Is féidir le Codex tástálacha atá ann cheana a fheabhsú, ní hamháin cinn nua a chruthú