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

error TS2693: 'Produs' only refers to a type, but is being used as a value here.

Pe scurt

Folosești o interfață sau un type ca și cum ar exista la rulare (new Produs(), x instanceof Produs, Produs.ceva). Tipurile dispar după compilare; folosește un obiect literal, o clasă sau o verificare cu in / typeof.

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

Ce înseamnă

TypeScript are două lumi: tipurile (interfețe, type, generice), care există doar la compilare și sunt șterse complet din JavaScript-ul rezultat, și valorile (variabile, funcții, clase), care există la rulare. O interfață Produs e doar o descriere a formei unui obiect; după compilare nu mai există nimic cu numele Produs.

Mesajul apare când pui un nume de tip într-un loc unde trebuie o valoare: după new, în dreapta lui instanceof, ca argument al unei funcții, în console.log sau la accesarea unei proprietăți.

Reparația depinde de intenție: vrei un obiect nou (scrii un literal { ... } cu tipul Produs), vrei o verificare la rulare (scrii un type guard cu in sau typeof), sau ai nevoie chiar de ceva care există la rulare (transformi interfața în clasă).

De ce apare: cauzele frecvente

1instanceof cu o interfață

Greșit
TypeScript
interface Card { numar: string }
function f(x: unknown) {
  if (x instanceof Card) {}
}
Corect
TypeScript
interface Card { numar: string }
function f(x: unknown) {
  if (typeof x === "object" && x !== null && "numar" in x) {}
}

instanceof are nevoie de o clasă care există la rulare; pentru interfețe verifici forma obiectului.

2new pe o interfață

Greșit
TypeScript
interface Produs { nume: string }
const p = new Produs();
Corect
TypeScript
interface Produs { nume: string }
const p: Produs = { nume: "Pix" };

Obiectele unei interfețe se creează cu un literal care respectă forma.

3Ai nevoie de comportament la rulare

Greșit
TypeScript
type Punct = { x: number; y: number };
const p = new Punct();
Corect
TypeScript
class Punct {
  constructor(public x = 0, public y = 0) {}
}
const p = new Punct();

O clasă este și tip, și valoare, deci o poți folosi cu new și instanceof.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2693: 'Card' only refers to a type, but is being used as a value here. Rescrie verificarea fără instanceof, ca programul să compileze și să afișeze Card ****1234 și apoi Numerar 50 lei.

Codul care dă eroarea
TypeScript
interface Card {
  ultimele4: string;
}
interface Numerar {
  suma: number;
}
function descrie(p: Card | Numerar): string {
  if (p instanceof Card) {
    return `Card ****${p.ultimele4}`;
  }
  return `Numerar ${p.suma} lei`;
}
console.log(descrie({ ultimele4: "1234" }));
console.log(descrie({ suma: 50 }));
După reparație, programul afișează
Card ****1234
Numerar 50 lei
Indiciu

Verifică dacă obiectul are proprietatea ultimele4 cu operatorul in.

Alte forme ale mesajului

  • error TS2693: 'number' only refers to a type, but is being used as a value here.
  • error TS2693: 'Partial' only refers to a type, but is being used as a value here.

Cum o eviți pe viitor

  • Ține minte regula: interfețele și type nu există la rulare.
  • Pentru verificări la rulare scrie funcții type guard (function esteCard(x): x is Card).
  • Când ai nevoie de new sau instanceof, folosește o clasă.
  • Scrie string, number doar în adnotări; ca valori folosește String(...), Number(...).

Întrebări frecvente

Pot obține lista câmpurilor dintr-o interfață la rulare?

Nu, interfața nu mai există după compilare. Dacă ai nevoie de listă, scrie-o ca valoare (const campuri = ["nume", "pret"] as const) și derivă tipul din ea, nu invers.

De ce instanceof merge cu Error sau Date?

Error și Date sunt clase (funcții constructor) care există la rulare. Interfețele tale nu sunt, de aceea ele dau TS2693.

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.