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

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.

Pe scurt

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

Greșit
TypeScript
// tsconfig.json: "types": []
const fs = require("fs");
Corect
TypeScript
// 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

Greșit
TypeScript
const port = process.env.PORT;
Corect
TypeScript
// 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

Greșit
TypeScript
const date = require("./produse.json");
Corect
TypeScript
const date = [{ nume: "Pix", pret: 3 }];

Fără Node nu poți citi fișiere; datele se scriu direct în program.

Repară tu

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.

Codul care dă eroarea
TypeScript
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}`);
După reparație, programul afișează
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.

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 de require î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

← 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.