...
Eroare TypeScript · Mediu, biblioteci și module

error TS2503: Cannot find namespace 'NodeJS'.

Pe scurt

Folosești un tip dintr-un namespace (NodeJS.Timeout, React.FC, Express.Request) pe care proiectul nu-l cunoaște, de obicei pentru că lipsesc tipurile pachetului (@types/node, @types/react) sau tsconfig le exclude. Instalează tipurile sau folosește un tip care nu depinde de mediu, ca ReturnType<typeof setTimeout>.

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

Ce înseamnă

Un nume cu punct într-o poziție de tip (NodeJS.Timeout) înseamnă „tipul Timeout din namespace-ul NodeJS”. Namespace-ul vine dintr-un fișier de declarații: NodeJS din @types/node, React din @types/react, Express din @types/express. Dacă pachetul de tipuri nu e instalat, nu e inclus în types din tsconfig, sau codul rulează într-un mediu fără Node (browser, editorul nostru), namespace-ul nu există.

Cel mai des apare cu let t: NodeJS.Timeout = setTimeout(...), cod copiat dintr-un proiect Node într-unul de browser sau invers. În browser, setTimeout întoarce un number, iar în Node un obiect Timeout.

Reparații: npm i -D @types/node (și "types": ["node"] în tsconfig, dacă lista e restrânsă) sau, pentru timere, tipul portabil ReturnType<typeof setTimeout>, care e corect în orice mediu.

De ce apare: cauzele frecvente

1Tip de timer specific Node

Greșit
TypeScript
let t: NodeJS.Timeout = setTimeout(() => {}, 100);
Corect
TypeScript
let t: ReturnType<typeof setTimeout> = setTimeout(() => {}, 100);

ReturnType<typeof setTimeout> e tipul real întors de setTimeout în mediul curent, fără să depindă de @types/node.

2Lipsesc tipurile pachetului

Greșit
TypeScript
npm i react
# în cod: const App: React.FC = () => null;
Corect
TypeScript
npm i react
npm i -D @types/react

Pachetele fără tipuri incluse au nevoie de pachetul @types/... care declară namespace-ul.

3tsconfig restrânge lista de tipuri

Greșit
TypeScript
{
  "compilerOptions": { "types": [] }
}
Corect
TypeScript
{
  "compilerOptions": { "types": ["node"] }
}

Când types e setat, sunt încărcate doar pachetele @types din listă.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos a fost copiat dintr-un proiect Node și dă eroarea TS2503: Cannot find namespace 'NodeJS'. Editorul nu are tipurile Node. Repară tipul variabilei timer cu un tip portabil, ca programul să afișeze Salvare automată anulată.

Codul care dă eroarea
TypeScript
let timer: NodeJS.Timeout | undefined;
function programeazaSalvare() {
  timer = setTimeout(() => console.log('Salvat'), 1000);
}
function anuleaza() {
  clearTimeout(timer);
  console.log('Salvare automată anulată');
}
programeazaSalvare();
anuleaza();
După reparație, programul afișează
Salvare automată anulată
Indiciu

Tipul corect e chiar tipul întors de setTimeout, obținut cu un tip utilitar.

Alte forme ale mesajului

  • error TS2503: Cannot find namespace 'React'.
  • error TS2503: Cannot find namespace 'Express'.

Cum o eviți pe viitor

  • Pentru timere scrie ReturnType<typeof setTimeout>, nu NodeJS.Timeout sau number.
  • Când instalezi un pachet, verifică dacă are tipuri incluse; dacă nu, instalează @types/<pachet> ca dependență de dezvoltare.
  • Dacă tsconfig are types, adaugă acolo pachetele de care ai nevoie.
  • După instalare, repornește serverul TypeScript al editorului.

Întrebări frecvente

De ce în proiectul Node merge, iar în cel de browser nu?

Proiectul Node are @types/node, care declară NodeJS. Proiectul de browser are tipurile DOM, unde setTimeout întoarce number, iar namespace-ul NodeJS nu există.

Am instalat @types/node și tot nu merge. De ce?

Verifică types și typeRoots din tsconfig: dacă sunt setate, pot exclude pachetul. Apoi repornește serverul TypeScript din editor (în VS Code: TypeScript: Restart TS Server).

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.