...
Eroare TypeScript · Tipuri de bază, nume și variabile

error TS2578: Unused '@ts-expect-error' directive.

Pe scurt

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ă

Greșit
TypeScript
// @ts-expect-error
const pret: number = 25;
Corect
TypeScript
const pret: number = 25;

Linia nu mai are eroare, deci comentariul nu mai are ce să ascundă.

2Comentariul e pe linia greșită

Greșit
TypeScript
// @ts-expect-error

const x: number = "5";
Corect
TypeScript
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ă

Greșit
TypeScript
// @ts-expect-error
const total: number = calculeaza();
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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`);
După reparație, programul afișează
Total: 36 lei
Indiciu

Directiva nu mai are ce eroare să ascundă, deci trebuie ștearsă.

Cum o eviți pe viitor

  • Folosește @ts-expect-error doar 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

← 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.