error TS2693: 'Produs' only refers to a type, but is being used as a value here.
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ță
interface Card { numar: string }
function f(x: unknown) {
if (x instanceof Card) {}
}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ță
interface Produs { nume: string }
const p = new Produs();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
type Punct = { x: number; y: number };
const p = new Punct();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ă 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.
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 }));Card ****1234 Numerar 50 lei
Indiciu
Verifică dacă obiectul are proprietatea ultimele4 cu operatorul in.
Reparația
interface Card {
ultimele4: string;
}
interface Numerar {
suma: number;
}
function descrie(p: Card | Numerar): string {
if ("ultimele4" in p) {
return `Card ****${p.ultimele4}`;
}
return `Numerar ${p.suma} lei`;
}
console.log(descrie({ ultimele4: "1234" }));
console.log(descrie({ suma: 50 }));De ce merge
Card e o interfață, deci după compilare nu mai există, iar instanceof ar avea nevoie de o clasă la rulare. Operatorul in verifică direct obiectul: dacă are proprietatea ultimele4, TypeScript restrânge tipul lui p la Card în acel if, iar după el știe că rămâne doar Numerar. Așa ambele ramuri compilează și obiectele literale sunt recunoscute corect.
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
typenu există la rulare. - Pentru verificări la rulare scrie funcții type guard (
function esteCard(x): x is Card). - Când ai nevoie de
newsauinstanceof, folosește o clasă. - Scrie
string,numberdoar în adnotări; ca valori foloseșteString(...),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
error TS2749: 'config' refers to a value, but is being used as a type here. Did you mean 'typeof config'? Ai pus numele unei variabile sau funcții într-un loc unde trebuie un tip (după :). Dacă vrei tipul acelei valori, scrie typeof config; dacă voiai o interfață, declar-o cu interface sau type. error TS2339: Property 'toUpperCase' does not exist on type 'string | number'. Variabila are un tip uniune (string | number), iar metoda există doar pe una dintre variante. Fă narrowing înainte: if (typeof x === "string") x.toUpperCase(); în ramura aceea TypeScript știe că e string. error TS18046: 'e' is of type 'unknown'. Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message). Î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.
