error TS2698: Spread types may only be created from object types.
Folosești ...valoare într-un obiect, dar TypeScript nu e sigur că valoarea e un obiect: e unknown, number, boolean sau o uniune care include un tip primitiv. Dă-i un tip obiect concret sau verifică tipul înainte de spread.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Sintaxa { ...a, x: 1 } copiază proprietățile lui a într-un obiect nou. TypeScript calculează tipul rezultatului din tipul lui a, deci trebuie să știe că a e un obiect. Dacă a e unknown, un number, un boolean sau o uniune care include un tip primitiv (Produs | string), nu poate construi tipul și dă TS2698.
Cazuri tipice: datele primite din JSON.parse sau de la un API, tipate unknown; un parametru care poate fi „obiect sau id” (Produs | number); o valoare primitivă desfăcută din greșeală în loc să fie pusă ca proprietate.
Linia din mesaj arată obiectul cu .... Treci cu mouse-ul peste variabila desfăcută și vezi ce tip are. Reparația e să-i dai un tip obiect: o interfață, o verificare typeof x === 'object' && x !== null care restrânge tipul, sau o ramură separată pentru cazul primitiv.
De ce apare: cauzele frecvente
1Date de tip unknown
const date: unknown = JSON.parse('{"a":1}');
const copie = { ...date };type Date = { a: number };
const date = JSON.parse('{"a":1}') as Date;
const copie = { ...date };Cu un tip obiect cunoscut, TypeScript știe ce proprietăți are copia. (Ideal, validezi datele înainte de cast.)
2Uniune cu un tip primitiv
type Produs = { nume: string };
function copie(p: Produs | number) {
return { ...p };
}type Produs = { nume: string };
function copie(p: Produs | number) {
return typeof p === 'number' ? { id: p } : { ...p };
}După verificarea typeof, pe ramura a doua p e sigur Produs, deci poate fi desfăcut.
3Desfaci o valoare primitivă
const pret: number = 10;
const o = { ...(pret as unknown) };const pret: number = 10;
const o = { pret };Un număr nu are proprietăți de copiat. Pune-l ca valoare a unei proprietăți.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2698: Spread types may only be created from object types. Datele vin dintr-un API ca unknown. Repară funcția ca programul să afișeze Produs: Lapte, id 1.
function cuId(obiect: unknown) {
return { ...obiect, id: 1 };
}
const produs = cuId({ nume: 'Lapte' });
console.log(`Produs: ${produs.nume}, id ${produs.id}`);Produs: Lapte, id 1
Indiciu
Dă parametrului un tip obiect, descris cu o interfață.
Reparația
interface Produs {
nume: string;
}
function cuId(obiect: Produs) {
return { ...obiect, id: 1 };
}
const produs = cuId({ nume: 'Lapte' });
console.log(`Produs: ${produs.nume}, id ${produs.id}`);De ce merge
Un parametru unknown poate fi orice, inclusiv un număr sau null, iar spread-ul cere un obiect. TypeScript nu poate construi tipul rezultatului, deci dă TS2698. Cu tipul Produs, funcția acceptă doar obiecte cu nume, iar rezultatul are tipul Produs & { id: number }, așa că produs.nume și produs.id sunt cunoscute.
Alte forme ale mesajului
error TS2698: Spread types may only be created from object types.
Cum o eviți pe viitor
- Dă tipuri concrete datelor primite din afară (interfață + validare), nu lucra cu
unknownmai departe decât e nevoie. - Când un parametru poate fi și obiect, și valoare simplă, tratează separat cele două cazuri cu
typeofînainte de spread. - Pentru tablouri folosește spread în tablou:
[...lista], nu în obiect.
Întrebări frecvente
De ce merge în JavaScript?
În JavaScript, { ...5 } dă {} și { ...null } dă tot {}, fără eroare. TypeScript refuză pentru că rezultatul aproape sigur nu e ce ai vrut și nu-i poate calcula tipul.
E la fel cu TS2700?
TS2700 (Rest types may only be created from object types) e varianta pentru destructurare: const { ...rest } = valoare. Cauza și reparația sunt aceleași.
Erori înrudite
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). 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 TS2352: Conversion of type 'string' to type 'number' may be a mistake because neither type sufficiently overlaps with the other. If this was intentional, convert the expression to 'unknown' first. Ai folosit as ca să transformi o valoare într-un tip complet diferit ("42" as number). as nu convertește nimic la rulare, doar schimbă ce crede compilatorul. Folosește o conversie reală: Number(text), String(n), sau verifică datele înainte. Î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.
