Conas a chuireann tú nótaí ar athróga, paraiméadair agus cineálacha tuairiscithe?

Question

Accepted Answer

Cuireann tú cineál i ndiaidh coilon. Is féidir le TypeScript go leor cineálacha a **bhreithniú**, agus mar sin cuireann tú nótaí áit ar bith a chuireann sé soiléireacht leis nó áit ar nach bhfuil breithniú indéanta.

```ts
// variables — usually let inference work
let count: number = 0;     // explicit
let name = "Ann";          // inferred as string (annotation redundant)

// function parameters — always annotate (can't be inferred)
function greet(name: string, times: number): string {
  return name.repeat(times);
}

// arrays and objects
const ids: number[] = [1, 2, 3];
const user: { name: string; age: number } = { name: "Ann", age: 30 };
```

## Cineálacha tuairiscithe: breithniú nó nótaí?

```ts
function add(a: number, b: number) { return a + b; } // inferred return: number
function load(): Promise<User> { ... }                // explicit — documents the contract
```

Braithíonn cineálacha tuairiscithe ar an tsistem, ach is dea-chleachtas iad a chur in iúl ar fheidhmeanna onnmhairithe/phoiblí: cuirtear an rún in iúl agus braithítear botúin *taobh istigh* den fheidhm (más rud é go dtugann tú an rud mícheart ar ais go turramhail, is ar an bhfeidhm, ní ar a glaochóirí, a bhíonn an earráid iontrálach).

## Cásanna speisialta

```ts
function log(msg: string): void {}     // returns nothing
function fail(): never { throw new Error(); } // never returns normally
const fn: (x: number) => string = ...; // function type annotation
```

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

An riail ordóg: **cuir nótaí ar shínithe feidhme (paraiméadair agus cineálacha tuairiscithe poiblí) go follasach, lig do athróga logánta a bheith i mbreithniú.** Coimeádann sé seo an cód gairid agus soiléir agus déantar na conarthaí ag teorainneacha feidhme a bheith soiléir agus seicnithe.