...
Eroare TypeScript · null, undefined și unknown

error TS18046: 'e' is of type 'unknown'.

Pe scurt

Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

unknown e varianta sigură a lui any: poate conține orice, dar nu te lasă să faci nimic cu valoarea până nu dovedești ce tip are. TS18046 apare când accesezi o proprietate, apelezi o metodă sau faci un calcul pe o valoare unknown.

Cel mai frecvent caz: în modul strict (useUnknownInCatchVariables), variabila din catch (e) are tipul unknown, pentru că în JavaScript se poate arunca orice, nu doar un Error: throw "text", throw 42. Deci e.message nu e garantat. Al doilea caz: date din exterior tipate intenționat unknown (răspunsuri de API, JSON.parse într-o funcție care întoarce unknown).

Repari cu narrowing: e instanceof Error, typeof x === "string", "camp" in x, sau un type guard propriu. După verificare, în ramura respectivă tipul e cel dovedit.

De ce apare: cauzele frecvente

1e.message în catch

Greșit
TypeScript
try {
  JSON.parse("{");
} catch (e) {
  console.log(e.message);
}
Corect
TypeScript
try {
  JSON.parse("{");
} catch (e) {
  console.log(e instanceof Error ? e.message : String(e));
}

instanceof Error dovedește că e are message; altfel îl transformi în text.

2Date unknown folosite direct

Greșit
TypeScript
function citeste(raspuns: unknown) {
  return raspuns.total * 2;
}
Corect
TypeScript
function citeste(raspuns: unknown) {
  if (typeof raspuns === "object" && raspuns !== null && "total" in raspuns && typeof raspuns.total === "number") {
    return raspuns.total * 2;
  }
  return 0;
}

Verifici pas cu pas: e obiect, nu e null, are total, iar total e număr.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS18046: 'e' is of type 'unknown'. Verifică în catch că eroarea e un Error înainte să-i citești mesajul, ca programul să afișeze Eroare: Stoc insuficient pentru laptop.

Codul care dă eroarea
TypeScript
function rezerva(produs: string, cantitate: number): void {
  if (cantitate > 2) {
    throw new Error(`Stoc insuficient pentru ${produs}`);
  }
}
try {
  rezerva("laptop", 5);
} catch (e) {
  console.log(`Eroare: ${e.message}`);
}
După reparație, programul afișează
Eroare: Stoc insuficient pentru laptop
Indiciu

Folosește e instanceof Error ca să ajungi la e.message.

Alte forme ale mesajului

  • error TS2571: Object is of type 'unknown'.

Cum o eviți pe viitor

  • În catch, folosește mereu e instanceof Error înainte de e.message (sau o funcție ajutătoare mesajEroare(e: unknown): string).
  • Aruncă doar obiecte Error în codul tău (throw new Error("...")), nu texte.
  • Pentru date din exterior, scrie o funcție de validare (type guard) care transformă unknown într-un tip precis.

Întrebări frecvente

De ce nu pot scrie catch (e: Error)?

Pentru că TypeScript permite în catch doar any sau unknown: nu poate garanta ce s-a aruncat. Verificarea se face în corp, cu instanceof.

Care e diferența între unknown și any?

Cu any poți face orice și pierzi verificările. Cu unknown nu poți face nimic până nu verifici tipul. Pentru date necunoscute, unknown e alegerea sigură.

Erori înrudite

← Toate erorile TypeScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață TypeScript de la zero, cu exerciții la fiecare lecție

Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.