error TS2353: Object literal may only specify known properties, and 'culoare' does not exist in type 'Produs'.
Ai scris într-un obiect literal un câmp pe care tipul țintă nu îl are (aici culoare). De obicei e un nume greșit sau un câmp uitat în interfață: corectează numele ori adaugă câmpul în tip.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Verificarea asta se numește excess property check: când scrii un obiect literal direct într-un loc tipat (variabilă, argument, return), TypeScript verifică să nu aibă câmpuri în plus față de tip. Motivul: un câmp în plus într-un literal e aproape mereu o greșeală de scriere (culoare în loc de culori, emial în loc de email) sau un câmp care ar trebui declarat.
Interesant e că verificarea se aplică doar literalelor scrise direct. Dacă obiectul e întâi pus într-o variabilă fără tip și abia apoi atribuit, câmpurile în plus sunt acceptate (tipurile TypeScript sunt structurale: „are cel puțin câmpurile cerute”).
Repari în funcție de intenție: corectezi numele, adaugi câmpul în interfață (eventual opțional) sau, dacă tipul permite chei arbitrare, adaugi o index signature.
De ce apare: cauzele frecvente
1Nume de câmp scris greșit
interface Client { nume: string; email: string }
const c: Client = { nume: "Ana", emial: "ana@x.ro" };interface Client { nume: string; email: string }
const c: Client = { nume: "Ana", email: "ana@x.ro" };emial nu există în tip; corect e email. (Aici TypeScript adaugă și sugestia „Did you mean to write 'email'?”.)
2Câmp nou, nedeclarat în interfață
interface Produs { nume: string; pret: number }
const p: Produs = { nume: "Tricou", pret: 49, culoare: "alb" };interface Produs { nume: string; pret: number; culoare?: string }
const p: Produs = { nume: "Tricou", pret: 49, culoare: "alb" };Dacă produsele pot avea culoare, câmpul se declară în interfață.
3Opțiuni trimise unei funcții
function conecteaza(o: { host: string; port: number }) {}
conecteaza({ host: "localhost", port: 5432, timeout: 30 });function conecteaza(o: { host: string; port: number; timeout?: number }) {}
conecteaza({ host: "localhost", port: 5432, timeout: 30 });Același control se aplică literalelor trimise ca argument.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2353: Object literal may only specify known properties, and 'reducere' does not exist in type 'Produs'. Produsele pot avea o reducere opțională: declar-o în interfață, ca programul să afișeze Bluză: 80 lei.
interface Produs {
nume: string;
pret: number;
}
const bluza: Produs = { nume: "Bluză", pret: 100, reducere: 20 };
const final = bluza.pret - (bluza.reducere ?? 0);
console.log(`${bluza.nume}: ${final} lei`);Bluză: 80 lei
Indiciu
Adaugă în interfață câmpul reducere ca opțional, de tip număr.
Reparația
interface Produs {
nume: string;
pret: number;
reducere?: number;
}
const bluza: Produs = { nume: "Bluză", pret: 100, reducere: 20 };
const final = bluza.pret - (bluza.reducere ?? 0);
console.log(`${bluza.nume}: ${final} lei`);De ce merge
Un obiect literal atribuit direct unei variabile tipate nu are voie să conțină câmpuri pe care tipul nu le declară, pentru că de obicei sunt greșeli. Aici reducere e intenționat, deci locul lui e în interfață. Declarat ca reducere?: number, câmpul poate lipsi la alte produse; de aceea calculul folosește bluza.reducere ?? 0, care înlocuiește undefined cu 0. (Fără câmpul în interfață, accesul bluza.reducere ar fi dat și TS2339.)
Alte forme ale mesajului
error TS2561: Object literal may only specify known properties, but 'emial' does not exist in type 'Client'. Did you mean to write 'email'?
Cum o eviți pe viitor
- Când vezi TS2353, verifică întâi dacă numele câmpului e scris corect.
- Ține interfețele la zi cu datele reale: câmpurile opționale se declară cu
?. - Nu ocoli verificarea punând literalul într-o variabilă intermediară: pierzi exact protecția la greșeli de scriere.
- Tipează variabila la declarare, ca verificarea să se aplice exact literalului.
Întrebări frecvente
De ce nu primesc eroarea când pun obiectul întâi într-o variabilă?
Pentru că verificarea câmpurilor în plus se face doar pentru literale scrise direct în locul tipat. O variabilă cu câmpuri în plus e compatibilă structural, deci e acceptată.
Cum permit chei arbitrare într-un tip?
Cu o index signature: interface Setari { tema: string; [cheie: string]: string }, sau cu Record<string, string>.
Erori înrudite
error TS2741: Property 'pret' is missing in type '{ nume: string; }' but required in type 'Produs'. Obiectul pe care îl atribui unui tip (aici Produs) nu are un câmp obligatoriu: lipsește pret. Adaugă câmpul în obiect sau, dacă poate lipsi cu adevărat, marchează-l opțional în interfață (pret?: number). error TS2739: Type '{ nume: string; }' is missing the following properties from type 'Produs': pret, stoc Obiectul nu are mai multe câmpuri obligatorii ale tipului așteptat; mesajul le enumeră la final (pret, stoc). Adaugă câmpurile lipsă sau, dacă obiectul e intenționat parțial, folosește alt tip, de exemplu Partial<Produs> sau Pick<Produs, "nume">. error TS2339: Property 'nume' does not exist on type 'Produs'. Accesezi o proprietate pe care tipul obiectului nu o are: interfața Produs nu declară câmpul nume. Fie ai scris greșit numele câmpului, fie lipsește din interfață și trebuie adăugat acolo. Î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.
