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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
require, module, process, __dirname, Buffer nu fac parte din limbajul JavaScript, ci din Node.js. TypeScript le cunoaște doar dacă are tipurile pachetului @types/node. Fără ele, primești acest mesaj, care îți spune exact ce să faci: instalezi @types/node și, dacă tsconfig are o listă types, adaugi "node" în ea. Varianta TS2580 apare când tsconfig nu are câmpul types (atunci instalarea pachetului e suficientă).
În proiectele TypeScript moderne, în loc de require se folosește import fs from "node:fs" (cu esModuleInterop) sau import * as fs from "node:fs", dar și acestea au nevoie de @types/node.
În editorul nostru, programul rulează ca o aplicație de consolă în browser: nu există Node, fișiere sau module. Codul trebuie să fie un singur fișier, iar datele le scrii direct în program.
De ce apare: cauzele frecvente
1Proiect Node fără tipuri
// tsconfig.json: "types": []
const fs = require("fs");// npm i --save-dev @types/node
// tsconfig.json: "types": ["node"]
import * as fs from "node:fs";Cu @types/node instalat și activat, TypeScript cunoaște modulele Node; import e forma recomandată.
2process.env în același context
const port = process.env.PORT;// după instalarea @types/node:
const port = process.env.PORT ?? "3000";process e tot din Node, deci aceeași reparație. Valoarea e string | undefined, deci dai una implicită.
3Cod pentru browser sau editorul online
const date = require("./produse.json");const date = [{ nume: "Pix", pret: 3 }];Fără Node nu poți citi fișiere; datele se scriu direct în program.
Repară eroarea, direct în pagină
Codul de mai jos a fost copiat dintr-un proiect Node și dă eroarea TS2591: Cannot find name 'require'. Editorul rulează fără Node, deci scoate require și scrie datele direct în program, ca să afișeze Produse: 2, total stoc: 15.
interface Produs {
nume: string;
stoc: number;
}
const produse: Produs[] = require("./produse.json");
const total = produse.reduce((s, p) => s + p.stoc, 0);
console.log(`Produse: ${produse.length}, total stoc: ${total}`);Produse: 2, total stoc: 15
Indiciu
Înlocuiește linia cu require cu un tablou de produse scris direct în cod, cu stocurile 10 și 5.
Reparația
interface Produs {
nume: string;
stoc: number;
}
const produse: Produs[] = [
{ nume: "Pix", stoc: 10 },
{ nume: "Caiet", stoc: 5 },
];
const total = produse.reduce((s, p) => s + p.stoc, 0);
console.log(`Produse: ${produse.length}, total stoc: ${total}`);De ce merge
require e o funcție a lui Node, nu a limbajului. TypeScript o cunoaște doar cu tipurile @types/node, iar editorul din browser nu are nici Node, nici fișierul produse.json. Într-un proiect Node reparația ar fi npm i -D @types/node, plus "node" în types, și import. Aici, datele scrise direct în program au aceeași formă Produs[], deci restul codului rămâne neschimbat și calculează totalul 10 + 5.
Alte forme ale mesajului
error TS2580: Cannot find name 'require'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node`.error TS2591: Cannot find name 'process'. 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.
Cum o eviți pe viitor
- La începutul unui proiect Node cu TypeScript:
npm i -D typescript @types/nodeși un tsconfig cu"types": ["node"]dacă listezi tipurile. - Folosește
importîn loc derequireîn fișierele.ts. - Separă codul care depinde de Node de cel care trebuie să ruleze și în browser.
Întrebări frecvente
De ce primesc uneori TS2580 și alteori TS2591?
Ambele spun că lipsesc tipurile Node. TS2591 apare când tsconfig are o listă types explicită (trebuie să adaugi "node" în ea), TS2580 când nu are.
Am instalat @types/node și tot primesc eroarea. De ce?
Verifică dacă tsconfig are "types": [...] fără "node": lista aceea restrânge tipurile globale încărcate. Repornește și serverul TypeScript din editor după instalare.
Erori înrudite
error TS2584: Cannot find name 'document'. Do you need to change your target library? Try changing the 'lib' compiler option to include 'dom'. TypeScript nu are tipurile pentru browser (DOM), deci nu cunoaște document, window sau HTMLElement. Într-un proiect web adaugă "dom" la lib în tsconfig; dacă rulezi în Node sau într-o consolă (ca editorul nostru), nu există DOM și folosești console.log. 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 TS2304: Cannot find name 'totl'. Folosești un nume (variabilă, funcție, tip) pe care TypeScript nu-l găsește nicăieri în scope. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau ceva ce nu există în mediul tău; corectează numele sau declară-l înainte. Î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.
