error TS2456: Type alias 'Lista' circularly references itself.
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
type Lista = Lista;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
type A = B;
type B = A | string;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
type Meniu = Partial<Meniu> & { titlu: string };interface Meniu {
titlu: string;
submeniu?: Meniu[];
}O interfață cu proprietăți recursive opționale descrie corect o structură imbricată.
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.
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}`);
}Electronice > Telefoane Electronice > Laptopuri
Indiciu
Subcategoriile sunt o listă de categorii, păstrată într-o proprietate.
Reparația
type Categorie = { nume: string; sub: 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}`);
}De ce merge
{ nume: string } & Categorie cerea ca TypeScript să calculeze Categorie chiar în timp ce o definește, o buclă fără sfârșit. Cu sub: Categorie[], referința la tip stă într-o proprietate de tablou, iar TypeScript o rezolvă doar când are nevoie. Tipul descrie acum un arbore, iar bucla afișează cele două subcategorii.
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
error TS2315: Type 'Produs' is not generic. Ai pus <...> după un tip care nu are parametri de tip (Produs<string>). Fie scoți parantezele unghiulare, fie faci tipul generic în declarație: interface Raspuns<T> { date: T }. error TS2304: Cannot find name 'totl'. Folosești un nume (variabilă, funcție, tip) pe care TypeScript nu-l găsește nicăieri în scope. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau ceva ce nu există în mediul tău; corectează numele sau declară-l înainte. error TS2314: Generic type 'Array<T>' requires 1 type argument(s). Ai folosit un tip generic (Array, Map, Promise, Record sau unul al tău) fără să spui tipul din interior. Adaugă argumentul între < >, de exemplu Array<number> sau number[], Map<string, number>, Promise<void>. Î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.
