...
Eroare TypeScript · Funcții, apeluri și async

error TS1196: Catch clause variable type annotation must be 'any' or 'unknown' if specified.

Pe scurt

Ai scris catch (e: Error). TypeScript nu permite alt tip decât any sau unknown la variabila din catch, pentru că poți arunca orice valoare. Scrie catch (e) sau catch (e: unknown) și verifică apoi cu instanceof Error.

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

Ce înseamnă

În JavaScript poți arunca orice: throw new Error('x'), dar și throw 'text' sau throw 42. De aceea TypeScript nu poate garanta ce tip are variabila din catch. Dacă îi scrii un tip precum Error, ar fi o promisiune falsă, așa că singurele adnotări permise sunt any și unknown.

Cu strict: true, variabila din catch e implicit unknown. Asta înseamnă că nu poți citi direct e.message (primești TS18046: 'e' is of type 'unknown'). Calea corectă e să verifici tipul în interior: if (e instanceof Error) { ... e.message ... }.

Linia din mesaj arată catch (...). Scoate adnotarea sau pune unknown, apoi restrânge tipul cu instanceof.

De ce apare: cauzele frecvente

1Tip concret pe variabila din catch

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

instanceof Error verifică la rulare ce ai prins și îi spune lui TypeScript tipul în acel bloc.

2Tip propriu de eroare

Greșit
TypeScript
class EroareValidare extends Error {}
try {} catch (e: EroareValidare) {}
Corect
TypeScript
class EroareValidare extends Error {}
try {} catch (e: unknown) {
  if (e instanceof EroareValidare) {}
}

TypeScript nu are catch pe tipuri, ca Java sau C#. Prinzi orice și apoi alegi cu instanceof.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1196: Catch clause variable type annotation must be 'any' or 'unknown' if specified. Repară blocul catch ca programul să afișeze Eroare: Stoc insuficient.

Codul care dă eroarea
TypeScript
function scoateDinStoc(buc: number) {
  if (buc > 3) throw new Error('Stoc insuficient');
}
try {
  scoateDinStoc(5);
} catch (e: Error) {
  console.log(`Eroare: ${e.message}`);
}
După reparație, programul afișează
Eroare: Stoc insuficient
Indiciu

Scoate tipul Error din catch și verifică tipul în interior.

Cum o eviți pe viitor

  • Scrie catch (e) și tratează e ca unknown: verifică întâi cu instanceof Error.
  • Aruncă mereu obiecte Error (sau subclase), niciodată texte simple, ca verificarea să fie simplă.
  • Pentru mai multe tipuri de erori, folosește mai multe if (e instanceof ...) în același catch.

Întrebări frecvente

De ce Java și C# permit catch pe tip, iar TypeScript nu?

În Java și C# poți arunca doar obiecte de excepție, iar limbajul alege blocul catch după tip la rulare. TypeScript se compilează în JavaScript, unde există un singur catch și se poate arunca orice valoare. Tipurile dispar la rulare, deci nu ar avea după ce alege.

E mai bine any sau unknown?

unknown. Cu any poți scrie e.message fără nicio verificare și primești eroare la rulare dacă s-a aruncat un text. unknown te obligă să verifici întâi.

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.