...
Eroare TypeScript · Generice

error TS2456: Type alias 'Lista' circularly references itself.

Pe scurt

Tipul se definește direct prin el însuși (type A = A, sau printr-un lanț de aliasuri), fără o structură (obiect, tablou) care să „oprească” recursivitatea. Tipurile recursive trebuie să treacă printr-un obiect sau tablou: type Nod = { copii: Nod[] }.

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

Ce înseamnă

TypeScript permite tipuri recursive, de exemplu un arbore (type Nod = { nume: string; copii: Nod[] }) sau JSON (type Json = string | number | Json[] | { [k: string]: Json }). Ce nu permite e un alias care trebuie „rezolvat” imediat în el însuși: type A = A, type A = B; type B = A, sau unele tipuri condiționale și utilitare aplicate chiar pe tipul în curs de definire.

Diferența: într-un obiect sau într-un tablou, referința la tip e amânată, pentru că TypeScript nu trebuie s-o calculeze ca să știe ce formă are tipul. Într-o uniune sau alias simplu fără structură, ar trebui să calculeze tipul pentru a-l defini, ceea ce e imposibil.

Linia din mesaj arată aliasul. Caută lanțul de referințe (poate trece prin mai multe aliasuri sau fișiere) și pune referința recursivă într-o proprietate de obiect sau într-un tablou. Uneori ajută să transformi aliasul în interface, care e mereu amânată.

De ce apare: cauzele frecvente

1Alias care se referă direct la el

Greșit
TypeScript
type Lista = Lista;
Corect
TypeScript
type Lista = { valoare: number; urmator: Lista | null };

Într-o proprietate de obiect, referința e amânată, deci tipul are o formă clară.

2Lanț de aliasuri

Greșit
TypeScript
type A = B;
type B = A | string;
Corect
TypeScript
type A = string | A[];

Un tip recursiv are nevoie de un caz de bază (string) și de o structură (tablou) pentru partea recursivă.

3Utilitar aplicat pe tipul în curs de definire

Greșit
TypeScript
type Meniu = Partial<Meniu> & { titlu: string };
Corect
TypeScript
interface Meniu {
  titlu: string;
  submeniu?: Meniu[];
}

O interfață cu proprietăți recursive opționale descrie corect o structură imbricată.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2456: Type alias 'Categorie' circularly references itself. O categorie are un nume și subcategorii. Repară tipul ca programul să afișeze Electronice > Telefoane și Electronice > Laptopuri.

Codul care dă eroarea
TypeScript
type Categorie = { nume: string } & Categorie;
const c: Categorie = {
  nume: 'Electronice',
  sub: [{ nume: 'Telefoane', sub: [] }, { nume: 'Laptopuri', sub: [] }],
};
for (const s of c.sub) {
  console.log(`${c.nume} > ${s.nume}`);
}
După reparație, programul afișează
Electronice > Telefoane
Electronice > Laptopuri
Indiciu

Subcategoriile sunt o listă de categorii, păstrată într-o proprietate.

Alte forme ale mesajului

  • error TS2456: Type alias 'Json' circularly references itself.

Cum o eviți pe viitor

  • Pune partea recursivă a unui tip mereu într-o proprietate sau într-un tablou: copii: Nod[].
  • Pentru structuri recursive complexe, preferă interface.
  • Gândește tipul recursiv ca o funcție recursivă: are nevoie de un caz de bază (o valoare simplă sau null).

Întrebări frecvente

De ce merge type Json = string | Json[], dar nu type A = string | A?

Json[] e un tablou, iar tablourile sunt amânate: tipul elementelor se calculează abia când e nevoie. A simplu într-o uniune ar trebui calculat imediat, ceea ce duce la o buclă fără sfârșit.

Tipurile recursive încetinesc compilarea?

Cele simple, nu. Tipurile condiționale recursive foarte adânci pot da alte erori, de exemplu TS2589 (Type instantiation is excessively deep and possibly infinite).

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.