Si i annotoni variablat, parametrat dhe llojet e kthimit?

Question

Accepted Answer

Ju shtoni një tip pas një dy pikash. TypeScript mund të **dedukojë** shumë lloje, kështu që ju annotoni ku shton qartësi ose ku deduktimi nuk është i mundur.

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

## Llojet e kthimit: deduksion apo annotim?

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

Llojet e kthimit dedulohen, por annotimi i tyre në funksionet e eksportuara/publike është një praktikë e mirë: dokumenton qëllimin dhe kap gabime *brenda* funksionit (nëse aksidentalisht ktheni diçka të gabuar, gabimi tregon në funksion, jo në thirrësit e tij).

## Rastet e veçanta

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

## Pse është i rëndësishëm

Rregulli i përgjithshëm: **annotoni nënshkrimet e funksionit (parametrat dhe llojet e kthimit publik) në mënyrë eksplicite, lejojini variablat lokal të dedulohen.** Kjo e mban kodin të shkurtër ndërsa i bën kontrattat në kufijtë e funksionit të qarta dhe të verifikuara.