error TS2503: Cannot find namespace 'NodeJS'.
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
let t: NodeJS.Timeout = setTimeout(() => {}, 100);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
npm i react
# în cod: const App: React.FC = () => null;npm i react
npm i -D @types/reactPachetele fără tipuri incluse au nevoie de pachetul @types/... care declară namespace-ul.
3tsconfig restrânge lista de tipuri
{
"compilerOptions": { "types": [] }
}{
"compilerOptions": { "types": ["node"] }
}Când types e setat, sunt încărcate doar pachetele @types din listă.
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ă.
let timer: NodeJS.Timeout | undefined;
function programeazaSalvare() {
timer = setTimeout(() => console.log('Salvat'), 1000);
}
function anuleaza() {
clearTimeout(timer);
console.log('Salvare automată anulată');
}
programeazaSalvare();
anuleaza();Salvare automată anulată
Indiciu
Tipul corect e chiar tipul întors de setTimeout, obținut cu un tip utilitar.
Reparația
let timer: ReturnType<typeof setTimeout> | undefined;
function programeazaSalvare() {
timer = setTimeout(() => console.log('Salvat'), 1000);
}
function anuleaza() {
clearTimeout(timer);
console.log('Salvare automată anulată');
}
programeazaSalvare();
anuleaza();De ce merge
NodeJS.Timeout e declarat în @types/node, care lipsește aici, deci namespace-ul NodeJS nu există. ReturnType<typeof setTimeout> cere direct tipul întors de funcția setTimeout din mediul curent (number în browser, Timeout în Node), deci codul compilează oriunde. Timer-ul e anulat înainte să ruleze, așa că se afișează doar mesajul de anulare.
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>, nuNodeJS.Timeoutsaunumber. - 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
error TS2591: Cannot find name 'require'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig. TypeScript nu cunoaște require (sau process, __dirname, Buffer) pentru că lipsesc tipurile pentru Node. Într-un proiect Node instalează @types/node și adaugă "node" la types în tsconfig; în editorul din browser nu există Node, deci scrii codul fără require. error TS2307: Cannot find module 'lodash' or its corresponding type declarations. TypeScript nu găsește modulul importat: pachetul nu e instalat, nu are tipuri, calea relativă e greșită sau rulezi într-un mediu fără module. Instalează pachetul (și @types/<pachet> dacă e nevoie), corectează calea sau, într-un singur fișier, scrie funcția local. error TS2694: Namespace 'Magazin' has no exported member 'Produs'. Folosești Magazin.Produs, dar în namespace-ul Magazin nu există un Produs exportat: ai uitat export în fața declarației, ai greșit numele sau tipul e în altă versiune a bibliotecii. Adaugă export sau folosește numele corect. Î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.
