error TS1196: Catch clause variable type annotation must be 'any' or 'unknown' if specified.
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
try {
JSON.parse('{');
} catch (e: Error) {
console.log(e.message);
}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
class EroareValidare extends Error {}
try {} catch (e: EroareValidare) {}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ă 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.
function scoateDinStoc(buc: number) {
if (buc > 3) throw new Error('Stoc insuficient');
}
try {
scoateDinStoc(5);
} catch (e: Error) {
console.log(`Eroare: ${e.message}`);
}Eroare: Stoc insuficient
Indiciu
Scoate tipul Error din catch și verifică tipul în interior.
Reparația
function scoateDinStoc(buc: number) {
if (buc > 3) throw new Error('Stoc insuficient');
}
try {
scoateDinStoc(5);
} catch (e) {
if (e instanceof Error) {
console.log(`Eroare: ${e.message}`);
}
}De ce merge
În JavaScript se poate arunca orice valoare, așa că TypeScript nu acceptă un tip concret, precum Error, pe variabila din catch. Fără adnotare, e e unknown. e instanceof Error verifică la rulare că ai prins chiar un obiect Error, iar în interiorul if TypeScript știe tipul și permite e.message.
Cum o eviți pe viitor
- Scrie
catch (e)și trateazăecaunknown: verifică întâi cuinstanceof 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șicatch.
Î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
error TS18046: 'e' is of type 'unknown'. 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). error TS2339: Property 'nume' does not exist on type 'Produs'. Accesezi o proprietate pe care tipul obiectului nu o are: interfața Produs nu declară câmpul nume. Fie ai scris greșit numele câmpului, fie lipsește din interfață și trebuie adăugat acolo. error TS2352: Conversion of type 'string' to type 'number' may be a mistake because neither type sufficiently overlaps with the other. If this was intentional, convert the expression to 'unknown' first. Ai folosit as ca să transformi o valoare într-un tip complet diferit ("42" as number). as nu convertește nimic la rulare, doar schimbă ce crede compilatorul. Folosește o conversie reală: Number(text), String(n), sau verifică datele înainte. Î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.
