...
Eroare TypeScript · Obiecte, interfețe și proprietăți

error TS2358: The left-hand side of an 'instanceof' expression must be of type 'any', an object type or a type parameter.

Pe scurt

Ai folosit instanceof pe o valoare primitivă (string, number, boolean): text instanceof String. Primitivele nu sunt obiecte, deci rezultatul ar fi mereu false. Pentru primitive folosește typeof x === 'string'; instanceof e pentru obiecte și clase.

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

Ce înseamnă

x instanceof C verifică dacă obiectul x a fost creat cu clasa C (sau o subclasă). Pentru valori primitive ('abc', 5, true), răspunsul e mereu false: 'abc' instanceof String dă false, pentru că 'abc' nu e un obiect String. TypeScript știe că tipul din stânga e primitiv și te oprește, ca să nu scrii o condiție care nu se îndeplinește niciodată.

Apare când vii din Java (unde instanceof String merge) sau când confunzi string cu clasa String. Mai apare la uniuni de primitive: if (v instanceof Number) pentru v: string | number.

Reparația: pentru primitive, typeof v === 'string' / 'number' / 'boolean'; pentru tablouri, Array.isArray(v); instanceof doar pentru obiecte (Date, Error, clasele tale).

De ce apare: cauzele frecvente

1instanceof pe un text

Greșit
TypeScript
const v: string = 'abc';
console.log(v instanceof String);
Corect
TypeScript
const v: string = 'abc';
console.log(typeof v === 'string');

Textele obișnuite nu sunt obiecte String; typeof e verificarea pentru primitive.

2instanceof pe o uniune de primitive

Greșit
TypeScript
function f(v: string | number) {
  return v instanceof Number ? v * 2 : v;
}
Corect
TypeScript
function f(v: string | number) {
  return typeof v === 'number' ? v * 2 : v;
}

typeof restrânge uniunea la number în ramura adevărată.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2358: The left-hand side of an 'instanceof' expression must be of type 'any', an object type or a type parameter. Funcția normalizează un ID primit ca text sau număr. Repar-o ca programul să afișeze ID-00042 și ID-00007.

Codul care dă eroarea
TypeScript
function normalizeaza(id: string | number): string {
  const nr = id instanceof String ? parseInt(id, 10) : id;
  return `ID-${String(nr).padStart(5, '0')}`;
}
console.log(normalizeaza('42'));
console.log(normalizeaza(7));
După reparație, programul afișează
ID-00042
ID-00007
Indiciu

Pentru valori primitive, verificarea de tip se face cu typeof.

Cum o eviți pe viitor

  • Folosește typeof pentru string, number, boolean, bigint, symbol, undefined și function.
  • Folosește instanceof pentru obiecte create cu new: Date, Error, Map, clasele tale.
  • Pentru tablouri, Array.isArray(x).
  • Nu crea primitive cu new String(...): obiectele wrapper complică orice comparație.

Întrebări frecvente

De ce 'abc' instanceof String dă false în JavaScript?

Pentru că 'abc' e o valoare primitivă, nu un obiect. Doar new String('abc') ar fi un obiect String. Metodele precum toUpperCase merg pe primitive printr-o conversie temporară, dar instanceof nu face conversia.

Cum verific dacă o valoare unknown e o eroare?

if (e instanceof Error) e corect: unknown e permis în stânga, iar Error e o clasă. După verificare, e.message e disponibil.

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.