Céard is cúngú cineáil ann agus conas a dhéanann an tiomsaitheoir é?

Question

Accepted Answer

**Cúngú** an bhealach a dhéanann TypeScript chun cineál leathan (cosúil le ceardchumann) a fhineáil go cineál níos sainiúla laistigh de bhrainse kóid, bunaithe ar sheiceanna fadréir an ama imeall. Ní dhéanann an tiomsaitheoir ach an sreabhadh rialaithe a rianú agus an cineál a thuiscint.

```ts
function process(x: string | number) {
  if (typeof x === "string") {
    x.toUpperCase(); // ✅ here x is narrowed to string
  } else {
    x.toFixed(2);    // ✅ here x must be number
  }
}
```

## Na huirlisí cúngaithe

```ts
typeof x === "string"          // typeof guard — for primitives
x instanceof Date              // instanceof — for classes
"role" in obj                  // in operator — property existence
Array.isArray(x)               // built-in guards
if (x) { ... }                  // truthiness narrows out null/undefined/0/""
if (x === null) { ... }         // equality narrowing
```

## Ceardchumainn idirghuaichte a chúngaíonn go geal

```ts
type Shape =
  | { kind: "circle"; r: number }
  | { kind: "square"; side: number };

function area(s: Shape) {
  switch (s.kind) {            // the discriminant
    case "circle": return Math.PI * s.r ** 2;  // s is the circle variant
    case "square": return s.side ** 2;          // s is the square variant
  }
}
```

A sheiceáil ar an réimse liteartha roinnte (`kind`) is gur insíonn sé don tiomsaitheoir go díreach cén leagan atá agat, ag oscailt airíonna an leagain sin.

## Gardaí saincheaptha a leathnú ar chúngú

```ts
function isUser(x: unknown): x is User { return !!x && typeof (x as any).name === "string"; }
```

## Fáth gur chóir dom a bheith ina thaobh

Is é an cúngú an rud a dhéanann ceardchumainn cineáil *inúsáidte* — tugann sé deis duit rochtain shábháilte ar bhallrachan sainiúil cineáil tar éis a chruthú an cineál, ag tiontú seiceanna fadréir an ama imeall i ngeallta tiomsúcháin.

Is é an meicníc laethúil é taobh thiar de dhéileáil le `string | number`, `T | null`, agus stádas lipéadaithe.