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

error TS2698: Spread types may only be created from object types.

Pe scurt

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

Greșit
TypeScript
const date: unknown = JSON.parse('{"a":1}');
const copie = { ...date };
Corect
TypeScript
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

Greșit
TypeScript
type Produs = { nume: string };
function copie(p: Produs | number) {
  return { ...p };
}
Corect
TypeScript
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ă

Greșit
TypeScript
const pret: number = 10;
const o = { ...(pret as unknown) };
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
function cuId(obiect: unknown) {
  return { ...obiect, id: 1 };
}
const produs = cuId({ nume: 'Lapte' });
console.log(`Produs: ${produs.nume}, id ${produs.id}`);
După reparație, programul afișează
Produs: Lapte, id 1
Indiciu

Dă parametrului un tip obiect, descris cu o interfață.

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 unknown mai 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

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