never is an cineál de luachanna nach dtarlaíonn riamh — feidhm nach bhfilleannn riamh (cuireann sí isteach nó lúb go brách), nó brainse a chruthaigh an tiomsaitheoir go bhfuil sé dodhéanta. Is é an cineál folamh a thugtar air: ní féidir le haon luach a bheith inúsáidte do never (ach never féin).
(): { (msg); }
(): { () {} }
never úsáideach: seiceanna traochtaNuair a laghdaíonn tú aontas go neamhní, déanann TypeScript an luach atá fágtha a chlóscríobh mar never. Úsáideann tú seo chun gach cás a láimhseáil:
type Shape =
| { kind: "circle"; r: number }
| { kind: "square"; side: number };
function area(s: Shape): number {
switch (s.kind) {
case "circle": return Math.PI * s.r ** 2;
case "square": return s.side ** 2;
default:
// if all cases are handled, s is `never` here — assignment OK
const _exhaustive: never = s;
return _exhaustive;
}
}
Anois má chuireann duine éigin { kind: "triangle"; ... } le Shape ach déanann sé dearmad ar chás, is é s san fhíor-chás an cineál triantáin (ní never), mar sin theipeann ar const _exhaustive: never = s agus beidh an tiomsú ar fáil — ag tabhairt isteach go díreach an switch a bheidh gá a nuashonrú.
never vs voidfunction a(): void {} // returns normally, just no value
function b(): never { throw "x"; } // never returns at all
Baineann never "ar láimhsíodh gach cás?" ó dhóchas fadú-ama go ráthúnas am tiomsaithe.
Is é an eochair do láimhseáil shábháilte, atá docht-dhíochta de aontais dhíscaoileadh — cuir leagan i láthair agus dhéanann an tiomsaitheoir cur síos ar gach áit ar ghá duit a nuashonrú.