...
Eroare TypeScript · Namespace-uri, enum-uri și tipuri imbricate

error TS2702: 'Comanda' only refers to a type, but is being used as a namespace here.

Pe scurt

Ai scris Comanda.Status ca și cum Status ar fi un tip definit în interiorul lui Comanda, ca în Java sau C#. În TypeScript, interfețele și tipurile nu conțin alte tipuri. Declară Status separat (type Status = ...) sau, dacă e o proprietate, folosește Comanda['status'].

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

Ce înseamnă

În pozițiile de tip, punctul (A.B) se folosește doar pentru namespace-uri (și enum-uri). Comanda e un type sau o interfață, deci nu are tipuri „înăuntru”, iar TypeScript îți spune că îl folosești ca pe un namespace. Diferența față de TS2713: acolo B era o proprietate a lui A; aici B nu e nici proprietate, deci TypeScript nu-ți poate sugera A['B'].

Apare la cei care vin din Java, C# sau Kotlin, unde tipurile imbricate (Comanda.Status) sunt comune, și când un tip a fost mutat dintr-un namespace într-un alias simplu.

Reparația: declară tipul separat la nivel de fișier (type StatusComanda = ...) și folosește-l direct. Dacă vrei neapărat gruparea, un namespace Comanda { export type Status = ... } poate sta lângă interfața cu același nume.

De ce apare: cauzele frecvente

1Tip imbricat ca în Java

Greșit
TypeScript
type Comanda = { id: number; status: string };
let s: Comanda.Status;
Corect
TypeScript
type StatusComanda = 'noua' | 'livrata';
type Comanda = { id: number; status: StatusComanda };
let s: StatusComanda;

Tipurile se declară la nivel de fișier și se folosesc direct, după nume.

2Gruparea cu un namespace

Greșit
TypeScript
interface Api { url: string }
let r: Api.Raspuns;
Corect
TypeScript
interface Api { url: string }
namespace Api {
  export type Raspuns = { ok: boolean };
}
let r: Api.Raspuns;

Un namespace cu același nume poate grupa tipuri legate de interfață.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2702: 'Comanda' only refers to a type, but is being used as a namespace here. Statusul comenzii e scris ca tip imbricat, ca în Java. Declară statusul ca tip separat, StatusComanda, ca programul să afișeze Comanda 12: livrata.

Codul care dă eroarea
TypeScript
type Comanda = {
  id: number;
  status: 'noua' | 'expediata' | 'livrata';
};
function marcheaza(c: Comanda, s: Comanda.Status): Comanda {
  return { ...c, status: s };
}
const c = marcheaza({ id: 12, status: 'noua' }, 'livrata');
console.log(`Comanda ${c.id}: ${c.status}`);
După reparație, programul afișează
Comanda 12: livrata
Indiciu

Mută uniunea de statusuri într-un type propriu și folosește-l atât în Comanda, cât și în funcție.

Alte forme ale mesajului

  • error TS2702: 'Produs' only refers to a type, but is being used as a namespace here.

Cum o eviți pe viitor

  • În TypeScript, declară tipurile legate unul lângă altul, cu nume clare (StatusComanda), nu imbricate.
  • Pentru tipul unei proprietăți folosește Tip['cheie'].
  • Grupează tipurile pe fișiere (module) în loc de namespace-uri: import type { Status } from './comanda'.
  • Dacă vii din Java sau C#, ține minte că aici tipurile nu se imbrică în clase sau interfețe.

Întrebări frecvente

Care e diferența față de TS2713?

La TS2713, partea de după punct e o proprietate existentă, iar TypeScript îți propune Tip['proprietate']. La TS2702, nu există o astfel de proprietate, deci ai vrut probabil un tip imbricat, care nu există în TypeScript.

Sunt namespace-urile încă recomandate?

Pentru cod nou, modulele (fișiere cu export și import) sunt varianta recomandată. Namespace-urile apar mai ales în fișiere de declarații și în cod mai vechi.

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.