...
Eroare TypeScript · Mediu, biblioteci și module

error TS2717: Subsequent property declarations must have the same type. Property 'id' must be of type 'number', but here has type 'string'.

Pe scurt

Aceeași interfață e declarată de două ori (în fișierul tău, într-un .d.ts sau într-o bibliotecă) și proprietatea apare cu tipuri diferite. Interfețele cu același nume se unesc, deci tipurile trebuie să fie identice: redenumește interfața ta sau aliniază tipul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În TypeScript, două interface cu același nume în același scope nu se suprascriu, ci se unesc (declaration merging): rezultatul are proprietățile ambelor. E util pentru a extinde tipuri globale sau din biblioteci. Dar dacă aceeași proprietate apare în ambele cu tipuri diferite, unirea e imposibilă și primești TS2717, cu detaliul: ce tip are de la prima declarație și ce tip i-ai dat aici.

Cazuri tipice: ai o interfață Produs în două fișiere script (fără import/export, deci ambele globale); ai definit o interfață cu același nume ca una globală (de exemplu Response, Event, Window când DOM e inclus); ai două versiuni ale aceluiași pachet @types/... în node_modules; sau extinzi o interfață de bibliotecă (Request din Express) cu un câmp care există deja cu alt tip.

Linia din mesaj e a doua declarație. Caută numele interfeței în proiect (inclusiv în .d.ts) ca să găsești prima.

De ce apare: cauzele frecvente

1Interfață declarată de două ori cu tipuri diferite

Greșit
TypeScript
interface Produs { id: number; nume: string }
// ... alt fișier global
interface Produs { id: string }
Corect
TypeScript
interface Produs { id: number; nume: string }
interface ProdusExtern { id: string }

Nume diferite pentru tipuri diferite: nu se mai unesc.

2Fișiere fără import/export, deci globale

Greșit
TypeScript
// a.ts
interface Config { port: number }
// b.ts
interface Config { port: string }
Corect
TypeScript
// a.ts
export interface Config { port: number }
// b.ts
export interface Config { port: string }

Cu export, fiecare fișier e un modul și are propria interfață Config.

3Extinzi o interfață existentă cu alt tip

Greșit
TypeScript
interface Utilizator { id: number }
interface Utilizator { id: number | string }
Corect
TypeScript
interface Utilizator { id: number }
interface Utilizator { email: string }

Prin unire poți adăuga proprietăți noi, nu poți schimba tipul celor existente.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2717: Subsequent property declarations must have the same type. Produsele din furnizor au codul text. Dă-le propria interfață ca programul să afișeze Intern 7: Lapte și Furnizor A-7: Lapte.

Codul care dă eroarea
TypeScript
interface Produs {
  id: number;
  nume: string;
}
interface Produs {
  id: string;
}
const intern: Produs = { id: 7, nume: 'Lapte' };
const extern: Produs = { id: 'A-7', nume: 'Lapte' };
console.log(`Intern ${intern.id}: ${intern.nume}`);
console.log(`Furnizor ${extern.id}: ${extern.nume}`);
După reparație, programul afișează
Intern 7: Lapte
Furnizor A-7: Lapte
Indiciu

Două interfețe cu același nume se unesc; tipul extern are nevoie de alt nume.

Cum o eviți pe viitor

  • Fă din fiecare fișier un modul (import/export), ca tipurile să nu devină globale și să nu se unească din greșeală.
  • Evită nume de interfețe care există deja global (Response, Request, Event, Node).
  • Dacă mesajul arată spre node_modules, verifică versiunile duplicate de @types/... cu npm ls @types/nume.

Întrebări frecvente

De ce două type cu același nume dau altă eroare?

Aliasurile type nu se unesc: două type Produs dau TS2300 (Duplicate identifier). Doar interface (și namespace-urile) participă la declaration merging.

Pot schimba tipul unei proprietăți dintr-o bibliotecă?

Nu prin unire. Poți crea propriul tip derivat: type Raspuns = Omit<RaspunsLib, 'id'> & { id: 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.