error TS2578: Unused '@ts-expect-error' directive.
Ai scris // @ts-expect-error deasupra unei linii care nu mai are nicio eroare. Comentariul cere să existe o eroare acolo; șterge-l, pentru că problema a fost deja reparată (sau mută-l pe linia corectă).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
// @ts-expect-error spune compilatorului: „pe linia următoare știu că va fi o eroare, ignor-o”. Spre deosebire de // @ts-ignore, el este verificat: dacă linia următoare compilează fără eroare, comentariul însuși devine eroare (TS2578). Avantajul: afli când nu mai ai nevoie de el.
Situații tipice: cineva a pus comentariul ca să treacă peste o eroare, apoi a reparat tipurile, dar a uitat comentariul; ai actualizat o bibliotecă și tipurile ei sunt acum corecte; sau comentariul e pus deasupra unei linii goale ori a unui alt comentariu, nu deasupra liniei cu problema.
Linia raportată este chiar linia comentariului. Reparația e aproape mereu să-l ștergi și să verifici că totul compilează.
De ce apare: cauzele frecvente
1Problema a fost deja reparată
// @ts-expect-error
const pret: number = 25;const pret: number = 25;Linia nu mai are eroare, deci comentariul nu mai are ce să ascundă.
2Comentariul e pe linia greșită
// @ts-expect-error
const x: number = "5";const x: number = Number("5");Comentariul se aplică doar liniei imediat următoare; mai bine repari chiar eroarea.
3Folosit ca să ascundă o eroare reală
// @ts-expect-error
const total: number = calculeaza();const total: number = calculeaza() ?? 0;Când eroarea dispare (sau se schimbă), comentariul te anunță; până atunci, încearcă să o repari de fapt.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2578: Unused '@ts-expect-error' directive, pentru că problema de tip a fost deja reparată. Curăță codul ca programul să compileze și să afișeze Total: 36 lei.
function total(pret: number, buc: number): number {
return pret * buc;
}
// @ts-expect-error pretul venea ca text
const t = total(12, 3);
console.log(`Total: ${t} lei`);Total: 36 lei
Indiciu
Directiva nu mai are ce eroare să ascundă, deci trebuie ștearsă.
Reparația
function total(pret: number, buc: number): number {
return pret * buc;
}
const t = total(12, 3);
console.log(`Total: ${t} lei`);De ce merge
@ts-expect-error cere ca linia următoare să conțină o eroare de tip. Apelul total(12, 3) primește acum două numere, deci e corect, iar comentariul a devenit inutil, lucru pe care TypeScript îl semnalează cu TS2578. După ștergerea lui, apelul compilează și calculează 12 * 3 = 36.
Cum o eviți pe viitor
- Folosește
@ts-expect-errordoar temporar sau în teste unde verifici intenționat că o linie nu compilează. - Adaugă un motiv după directivă:
// @ts-expect-error biblioteca X are tipuri greșite. - Preferă-l lui
@ts-ignore, tocmai pentru că primești TS2578 când nu mai e nevoie de el. - Caută periodic în proiect aceste comentarii și elimină-le pe cele care nu mai sunt justificate.
Întrebări frecvente
Care e diferența dintre @ts-ignore și @ts-expect-error?
Ambele ascund eroarea de pe linia următoare. @ts-ignore tace mereu, chiar dacă linia e corectă. @ts-expect-error cere ca linia să aibă o eroare și dă TS2578 când nu mai are.
Pot folosi directiva în teste?
Da, e un mod obișnuit de a verifica tipurile unei biblioteci: scrii un apel greșit cu // @ts-expect-error deasupra; dacă tipurile devin prea permisive și apelul trece, testul pică cu TS2578.
Erori înrudite
error TS2322: Type 'string' is not assignable to type 'number'. Ai pus un text (string) într-o variabilă, un câmp sau un rezultat declarat ca number. Repari convertind textul în număr cu Number() sau parseFloat(), ori schimbând tipul declarat dacă valoarea chiar trebuie să fie text. error TS7006: Parameter 'pret' implicitly has an 'any' type. Parametrul unei funcții nu are tip, iar în modul strict TypeScript refuză să-l considere any în tăcere. Adaugă tipul după numele parametrului, de exemplu (pret: number), sau folosește funcția într-un loc din care tipul poate fi dedus. error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'. Ai apelat o funcție cu un argument de alt tip decât cel declarat la parametru: funcția așteaptă number și primește string. Convertește valoarea înainte de apel (Number(...)) sau verifică dacă ai pus argumentele în ordinea corectă. Î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.
