error TS2559: Type '{ sort: string; limit: number; }' has no properties in common with type 'Optiuni'.
Trimiți un obiect unui tip în care toate proprietățile sunt opționale, dar obiectul nu are niciuna dintre ele, de obicei din cauza unor nume greșite (sort în loc de sortare). Corectează numele proprietăților ca să se potrivească cu tipul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un tip în care toate proprietățile sunt opționale (de exemplu un obiect de opțiuni { sortare?: string; limita?: number }) se numește „weak type”. Teoretic, orice obiect l-ar respecta, pentru că nicio proprietate nu e obligatorie. Ca să prindă greșelile, TypeScript are o regulă în plus: obiectul trebuie să aibă cel puțin o proprietate comună cu tipul. Dacă nu are niciuna, aproape sigur ai scris greșit numele.
Mesajul afișează tipul obiectului tău ({ sort: string; limit: number; }) și tipul așteptat. Compară numele unul câte unul.
Cu un literal scris direct în apel primești de obicei TS2353 (Object literal may only specify known properties). TS2559 apare când obiectul e construit înainte, într-o variabilă, sau când trimiți o valoare de alt tip (de exemplu un string) unde se așteaptă opțiuni.
De ce apare: cauzele frecvente
1Nume greșite într-un obiect de opțiuni
interface Optiuni { sortare?: string; limita?: number }
const opt = { sort: "pret", limit: 5 };
const o: Optiuni = opt;interface Optiuni { sortare?: string; limita?: number }
const opt = { sortare: "pret", limita: 5 };
const o: Optiuni = opt;Cu numele corecte, obiectul are proprietăți comune cu tipul, deci e acceptat.
2Valoare simplă în loc de obiect de opțiuni
function cauta(o: { limita?: number }) {}
cauta(10);function cauta(o: { limita?: number }) {}
cauta({ limita: 10 });Funcția așteaptă un obiect cu opțiuni, nu numărul direct.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2559: Type '{ sort: string; limit: number; }' has no properties in common with type 'Optiuni'. Corectează numele din obiectul opt ca programul să afișeze Sortare după pret, primele 5.
interface Optiuni {
sortare?: string;
limita?: number;
}
function descrie(o: Optiuni): string {
return `Sortare după ${o.sortare ?? "nume"}, primele ${o.limita ?? 10}`;
}
const opt = { sort: "pret", limit: 5 };
console.log(descrie(opt));Sortare după pret, primele 5
Indiciu
Numele proprietăților din opt trebuie să fie exact cele din interfața Optiuni.
Reparația
interface Optiuni {
sortare?: string;
limita?: number;
}
function descrie(o: Optiuni): string {
return `Sortare după ${o.sortare ?? "nume"}, primele ${o.limita ?? 10}`;
}
const opt = { sortare: "pret", limita: 5 };
console.log(descrie(opt));De ce merge
Toate câmpurile din Optiuni sunt opționale, deci TypeScript cere doar ca obiectul să aibă cel puțin unul dintre ele. sort și limit nu există în interfață, așa că obiectul nu avea nimic în comun cu ea și, la rulare, funcția ar fi folosit valorile implicite. Cu sortare și limita, opțiunile ajung în funcție și se afișează pret și 5.
Alte forme ale mesajului
error TS2559: Type '10' has no properties in common with type '{ limita?: number | undefined; }'.
Cum o eviți pe viitor
- Copiază numele proprietăților din tip (sau folosește autocompletarea editorului) când construiești obiecte de opțiuni.
- Adnotează variabila chiar la creare (
const opt: Optiuni = { ... }), ca greșelile să fie raportate pe linia unde le-ai făcut. - Pentru opțiuni, preferă nume clare și consecvente în tot proiectul.
- Dacă un câmp trebuie să existe mereu, nu-l marca opțional.
Întrebări frecvente
De ce nu primesc eroarea dacă obiectul are măcar o proprietate corectă?
Regula „weak type” verifică doar că există cel puțin o proprietate comună. Restul proprietăților în plus sunt raportate doar dacă scrii obiectul literal direct în locul unde e folosit (TS2353).
Care e diferența față de TS2353?
TS2353 apare la un literal scris direct, pentru fiecare proprietate necunoscută. TS2559 apare la orice valoare care nu are nicio proprietate comună cu un tip cu toate câmpurile opționale.
Erori înrudite
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. 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.
