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

error TS2708: Cannot use namespace 'Api' as a value.

Pe scurt

Namespace-ul conține doar tipuri (interfețe, type), deci la rulare nu există. Tu îl folosești ca valoare: new Api.Produs(), console.log(Api) sau Api.ceva într-o expresie. Folosește tipurile doar în adnotări (const p: Api.Produs = {...}) sau adaugă în namespace o valoare reală (o funcție, o clasă).

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

Ce înseamnă

Un namespace care conține doar tipuri dispare complet la compilare: nu se generează niciun obiect JavaScript pentru el. De aceea poate fi folosit doar în poziții de tip (let p: Api.Produs). Când îl folosești într-o expresie (o valoare care trebuie să existe la rulare), TypeScript raportează TS2708.

Cazuri tipice: new Api.Produs() când Produs e o interfață (vrei un obiect cu acea formă, nu o instanță de clasă), Api.Status.Activ când Status e un type cu literale, nu un enum, sau o funcție dintr-o bibliotecă ale cărei declarații au doar tipuri.

Reparația: pentru obiecte, scrie un literal cu tipul din namespace (const p: Api.Produs = { ... }); dacă ai nevoie de valori la rulare, declară în namespace o clasă, o funcție, o constantă sau un enum, cu export.

De ce apare: cauzele frecvente

1new pe o interfață din namespace

Greșit
TypeScript
namespace Api { export interface Produs { id: number } }
const p = new Api.Produs();
Corect
TypeScript
namespace Api { export interface Produs { id: number } }
const p: Api.Produs = { id: 1 };

O interfață nu are constructor; obiectul se scrie ca literal cu tipul interfeței.

2Literal dintr-un type folosit ca enum

Greșit
TypeScript
namespace Api { export type Status = 'activ' | 'inactiv' }
const s = Api.Status;
Corect
TypeScript
namespace Api { export type Status = 'activ' | 'inactiv' }
const s: Api.Status = 'activ';

Status e doar un tip; valoarea e textul 'activ'. Dacă vrei Api.Status.Activ, declară un enum.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2708: Cannot use namespace 'Api' as a value. Namespace-ul conține doar interfața unui produs. Creează produsul ca obiect literal, cu tipul din namespace, ca programul să afișeze Produs 3: Miere, 35 lei.

Codul care dă eroarea
TypeScript
namespace Api {
  export interface Produs {
    id: number;
    nume: string;
    pret: number;
  }
}
const p = new Api.Produs(3, 'Miere', 35);
console.log(`Produs ${p.id}: ${p.nume}, ${p.pret} lei`);
După reparație, programul afișează
Produs 3: Miere, 35 lei
Indiciu

Pune Api.Produs ca tip al constantei și scrie valorile între acolade.

Alte forme ale mesajului

  • error TS2708: Cannot use namespace 'Tipuri' as a value.

Cum o eviți pe viitor

  • Ține minte: interfețele și aliasurile type nu există la rulare, nici când sunt într-un namespace.
  • Creează obiecte cu literale tipate (const p: Api.Produs = {...}) sau cu o funcție fabrică.
  • Când ai nevoie de constante grupate, folosește un enum sau un obiect as const.
  • Pentru tipuri din biblioteci, verifică dacă pachetul exportă și valori, nu doar declarații.

Întrebări frecvente

De ce un namespace cu o funcție poate fi folosit ca valoare?

Pentru că funcția există la rulare, deci TypeScript generează un obiect JavaScript pentru namespace. Un namespace doar cu tipuri nu generează nimic.

Care e legătura cu TS2693?

Sunt aceeași idee la niveluri diferite: TS2693 spune că un tip (interfață) e folosit ca valoare, TS2708 spune același lucru despre un namespace care conține doar tipuri.

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.