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

error TS2359: The right-hand side of an 'instanceof' expression must be either of type 'any', a class, function, or other type assignable to the 'Function' interface type, or an object type with a 'Symbol.hasInstance' method.

Pe scurt

În dreapta lui instanceof ai pus ceva care nu e o clasă sau un constructor, de obicei un text ca 'string' sau un obiect simplu. Pentru tipuri primitive folosește typeof v === 'string'; pentru obiecte, instanceof cu numele clasei (Date, Error).

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

Ce înseamnă

x instanceof C verifică la rulare dacă obiectul x a fost creat cu constructorul C (sau cu o subclasă). Pentru asta, C trebuie să fie o valoare care există la rulare și se poate folosi ca constructor: o clasă, o funcție constructor (Date, Error, Map) sau un obiect cu metoda Symbol.hasInstance.

TS2359 apare când în dreapta e altceva: un text (v instanceof 'string', confuzie cu typeof), un număr, un obiect obișnuit sau o variabilă care ține numele clasei ca text. JavaScript ar arunca la rulare TypeError: Right-hand side of 'instanceof' is not callable, iar TypeScript te oprește înainte.

Dacă în dreapta ai pus o interfață sau un type alias, primești altă eroare (TS2693: only refers to a type, but is being used as a value), pentru că acelea nu există la rulare.

De ce apare: cauzele frecvente

1instanceof folosit pentru tipuri primitive

Greșit
TypeScript
function descrie(v: unknown) {
  if (v instanceof 'string') return 'text';
  return 'alt tip';
}
Corect
TypeScript
function descrie(v: unknown) {
  if (typeof v === 'string') return 'text';
  return 'alt tip';
}

Textele, numerele și booleenii nu sunt obiecte create cu un constructor. Se verifică cu typeof.

2Numele clasei ținut ca text

Greșit
TypeScript
const tip = 'Date';
const ok = new Date() instanceof tip;
Corect
TypeScript
const ok = new Date() instanceof Date;

instanceof are nevoie de constructorul însuși, nu de numele lui. Folosește direct clasa.

3Obiect simplu în loc de clasă

Greșit
TypeScript
const Produs = { nume: 'Ceai' };
const x: unknown = {};
x instanceof Produs;
Corect
TypeScript
class Produs { nume = 'Ceai'; }
const x: unknown = new Produs();
x instanceof Produs;

Un obiect literal nu poate crea instanțe. Ca să folosești instanceof, ai nevoie de o clasă.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2359: The right-hand side of an 'instanceof' expression must be either of type 'any', a class, function, .... Funcția trebuie să recunoască textele. Repar-o ca programul să afișeze text: ceai și apoi alt tip.

Codul care dă eroarea
TypeScript
function descrie(v: unknown): string {
  if (v instanceof 'string') {
    return 'text: ' + v;
  }
  return 'alt tip';
}

console.log(descrie('ceai'));
console.log(descrie(5));
După reparație, programul afișează
text: ceai
alt tip
Indiciu

Textele sunt valori primitive: se verifică cu alt operator decât instanceof.

Cum o eviți pe viitor

  • Reține regula: typeof pentru primitive (string, number, boolean, undefined), instanceof pentru obiecte create cu clase (Date, Error, clasele tale), Array.isArray pentru tablouri.
  • Pentru obiecte descrise de interfețe, folosește verificarea unei proprietăți ('pret' in x) sau un type guard.
  • Dacă vrei să alegi clasa dinamic, ține clasele într-o hartă ({ Date, Error }), nu numele lor ca text.

Întrebări frecvente

Pot folosi instanceof cu o interfață?

Nu. Interfețele dispar la compilare, deci nu există nimic cu care să compari la rulare. Primești TS2693. Folosește un type guard care verifică proprietățile, de exemplu function esteProdus(x: any): x is Produs { return typeof x?.pret === 'number'; }.

De ce new String('a') instanceof String e true, dar 'a' instanceof String e false?

new String('a') creează un obiect-ambalaj, iar 'a' e o valoare primitivă, care nu are lanț de prototipuri propriu. De aceea pentru texte se folosește typeof.

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.