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

error TS2709: Cannot use namespace 'Magazin' as a type.

Pe scurt

Ai folosit un namespace (sau un import * as X) ca tip: const p: Magazin. Un namespace e un container, nu un tip. Folosește tipul din interiorul lui: Magazin.Produs, sau importă tipul corect din bibliotecă.

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

Ce înseamnă

Un namespace grupează declarații: interfețe, funcții, constante. El însuși nu e un tip, ci un loc în care stau tipuri. Când scrii let p: Magazin, TypeScript găsește un namespace cu acest nume, dar nu un tip, și dă TS2709.

Cel mai des apare cu importuri de tip namespace: import * as express from 'express' creează un nume care conține tot modulul, iar let app: express dă aceeași eroare. Tipul corect e un membru al lui: express.Express, express.Request. La fel cu biblioteci vechi care exportă un namespace cu același nume ca funcția principală.

Citește numele din mesaj, apoi uită-te ce conține (autocompletarea după Magazin. îți arată membrii) și alege tipul potrivit.

De ce apare: cauzele frecvente

1Namespace în loc de tipul din el

Greșit
TypeScript
namespace Magazin {
  export interface Produs { nume: string }
}
const p: Magazin = { nume: 'Ceai' };
Corect
TypeScript
namespace Magazin {
  export interface Produs { nume: string }
}
const p: Magazin.Produs = { nume: 'Ceai' };

Tipul e Produs, membrul namespace-ului, deci se scrie Magazin.Produs.

2Import de modul folosit ca tip

Greșit
TypeScript
import * as express from 'express';
let app: express;
Corect
TypeScript
import express, { Express } from 'express';
let app: Express = express();

import * as dă un namespace cu tot modulul. Tipul aplicației e exportat separat, ca Express.

3Ai vrut tipul unei valori din namespace

Greșit
TypeScript
namespace Config {
  export const implicit = { tema: 'dark' };
}
let c: Config;
Corect
TypeScript
namespace Config {
  export const implicit = { tema: 'dark' };
}
let c: typeof Config.implicit;

Pentru tipul unei constante folosește typeof, aplicat pe membrul namespace-ului.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2709: Cannot use namespace 'Magazin' as a type. Constanta p trebuie să fie un produs, descris de interfața din namespace. Repară tipul ca programul să afișeze Ceai: 12 lei.

Codul care dă eroarea
TypeScript
namespace Magazin {
  export interface Produs {
    nume: string;
    pret: number;
  }
  export function eticheta(p: Produs): string {
    return `${p.nume}: ${p.pret} lei`;
  }
}

const p: Magazin = { nume: 'Ceai', pret: 12 };
console.log(Magazin.eticheta(p));
După reparație, programul afișează
Ceai: 12 lei
Indiciu

Tipul de care ai nevoie stă în interiorul namespace-ului și se accesează cu punct.

Alte forme ale mesajului

  • error TS2709: Cannot use namespace 'express' as a type.

Cum o eviți pe viitor

  • Când folosești un namespace, scrie mereu calea completă până la tip: Namespace.Tip.
  • La biblioteci, caută în documentație sau în fișierul .d.ts numele exact al tipului exportat.
  • Preferă importurile cu nume (import { Request } from 'express') în locul lui import * as, ca să lucrezi direct cu tipuri.
  • Pentru tipul unei valori folosește typeof valoare.

Întrebări frecvente

Care e diferența față de TS2708?

TS2708 (Cannot use namespace 'X' as a value) apare când folosești namespace-ul ca valoare (îl apelezi sau îl atribui), iar el conține doar tipuri. TS2709 e opusul: îl folosești ca tip.

De ce cu unele biblioteci merge let x: Nume?

Pentru că acolo Nume e în același timp namespace și tip (de exemplu o interfață și un namespace cu același nume, unite prin declaration merging). Dacă biblioteca exportă doar namespace-ul, trebuie să alegi tipul din el.

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.