unknown

V lekci Základní typy jste poznali typ any, který kontrolu typů vypne: TypeScript dovolí cokoli a chyby z JavaScriptu jsou zpátky. Někdy ale opravdu nevíte, co je hodnota zač. Data, která přicházejí zvenku, třeba z uložené hry, ze souboru nebo ze zprávy ze serveru, mohou obsahovat cokoli: možná číslo, které čekáte, možná text, možná vůbec nic.

Pro takové hodnoty má TypeScript typ unknown (anglicky „neznámý“). Stejně jako any přijme jakoukoli hodnotu. Na rozdíl od any vám ale s hodnotou nedovolí nic dělat, dokud nezjistíte, co je zač:

const ulozeneJmeno: unknown = "Kira";
console.log(ulozeneJmeno);
console.log(ulozeneJmeno.toUpperCase());

main.ts(3,13): error TS18046: 'ulozeneJmeno' is of type 'unknown'.

Vypsat hodnotu jde, protože console.log přijme cokoli. Zavolat metodu ale nejde: hodnota může být číslo a program by pak spadl. Hodnotu typu unknown nemůžete uložit ani do proměnné jiného typu: const jmenoHrdiny: string = ulozeneJmeno; skončí chybou error TS2322: Type 'unknown' is not assignable to type 'string'.

K hodnotě se dostanete zúžením, kontrolami, které už znáte:

const ulozeneJmeno: unknown = "Kira";

if (typeof ulozeneJmeno === "string") {
    console.log(ulozeneJmeno.toUpperCase());
} else {
    console.log("Uložená hra neobsahuje jméno");
}

Vypíše:

KIRA

Uvnitř if je ulozeneJmeno typu string a smíte s ním dělat všechno, co jde s texty. V tom je celý rozdíl mezi oběma typy. S any můžete na kontrolu zapomenout a program spadne, až poběží (s const ulozeneJmeno: any = 42; skončí volání chybou TypeError: ulozeneJmeno.toUpperCase is not a function). S unknown zapomenout nemůžete: TypeScript kontrolu vyžaduje.

Když tedy typ hodnoty neznáte, napište unknown, ne any. A když v programu uvidíte any, zeptejte se, jestli by nestačil skutečný typ, nebo aspoň unknown.