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

error TS2353: Object literal may only specify known properties, and 'culoare' does not exist in type 'Produs'.

Pe scurt

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

Greșit
TypeScript
interface Client { nume: string; email: string }
const c: Client = { nume: "Ana", emial: "ana@x.ro" };
Corect
TypeScript
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ță

Greșit
TypeScript
interface Produs { nume: string; pret: number }
const p: Produs = { nume: "Tricou", pret: 49, culoare: "alb" };
Corect
TypeScript
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

Greșit
TypeScript
function conecteaza(o: { host: string; port: number }) {}
conecteaza({ host: "localhost", port: 5432, timeout: 30 });
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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`);
După reparație, programul afișează
Bluză: 80 lei
Indiciu

Adaugă în interfață câmpul reducere ca opțional, de tip număr.

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

← 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.