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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Obiectele document, window, localStorage, HTMLElement vin din biblioteca de tipuri lib.dom.d.ts. Ea se încarcă doar dacă opțiunea lib din tsconfig include "dom" (sau dacă nu setezi lib deloc și TypeScript alege implicit). Când lib e setat doar la versiuni ES (de exemplu ["es2022"]), DOM-ul lipsește și primești TS2584.
Asta e corect pentru proiectele Node și pentru codul care rulează ca aplicație de consolă: acolo nu există pagină, deci nici document. Dacă proiectul tău chiar e pentru browser, configurația e greșită: "lib": ["es2022", "dom", "dom.iterable"].
Editorul nostru TypeScript rulează fără DOM (lib ES2022), ca o consolă: pentru afișare folosești console.log. Lucrul cu pagina îl exersezi în cursurile de JavaScript și React.
De ce apare: cauzele frecvente
1Proiect web fără lib dom
// tsconfig.json: "lib": ["es2022"]
document.title = "Magazin";// tsconfig.json: "lib": ["es2022", "dom", "dom.iterable"]
document.title = "Magazin";Cu dom în lib, tipurile browserului sunt disponibile.
2Cod de browser rulat în consolă
const total = 120;
document.getElementById("total")!.textContent = `${total} lei`;const total = 120;
console.log(`${total} lei`);Într-o aplicație de consolă (Node, editorul nostru) nu există pagină; afișarea se face cu console.log.
3window pentru valori globale
window.setTimeout(() => console.log("gata"), 10);setTimeout(() => console.log("gata"), 10);setTimeout există și fără DOM; nu ai nevoie de window în față (care aici ar da TS2304).
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2584: Cannot find name 'document', pentru că editorul rulează fără DOM, ca o consolă. Înlocuiește scrierea în pagină cu console.log, ca programul să afișeze Coș: 3 produse, 74.50 lei.
const cos: { nume: string; pret: number }[] = [
{ nume: "Ceai", pret: 12.5 },
{ nume: "Miere", pret: 32 },
{ nume: "Biscuiți", pret: 30 },
];
const total = cos.reduce((s, p) => s + p.pret, 0);
const text = `Coș: ${cos.length} produse, ${total.toFixed(2)} lei`;
document.body.textContent = text;Coș: 3 produse, 74.50 lei
Indiciu
Păstrează textul calculat și trimite-l la console.log în loc de document.body.textContent.
Reparația
const cos: { nume: string; pret: number }[] = [
{ nume: "Ceai", pret: 12.5 },
{ nume: "Miere", pret: 32 },
{ nume: "Biscuiți", pret: 30 },
];
const total = cos.reduce((s, p) => s + p.pret, 0);
const text = `Coș: ${cos.length} produse, ${total.toFixed(2)} lei`;
console.log(text);De ce merge
document aparține browserului și e descris de biblioteca de tipuri dom. Editorul compilează cu lib ES2022, fără dom, pentru că programul rulează ca o aplicație de consolă, unde nu există pagină. Calculul coșului nu depinde de DOM, așa că rămâne neschimbat; doar afișarea trece prin console.log. Într-un proiect web adevărat, reparația ar fi "lib": ["es2022", "dom"] în tsconfig.
Alte forme ale mesajului
error TS2304: Cannot find name 'window'.error TS2304: Cannot find name 'HTMLElement'.
Cum o eviți pe viitor
- Alege
libdupă unde rulează codul:dompentru browser,@types/nodepentru Node, ambele doar dacă e cod chiar comun. - Separă logica (calcule, validări) de afișare, ca s-o poți rula și testa fără DOM.
- Nu folosi
declare const document: anyca să scapi de eroare: ascunde o problemă de configurare.
Întrebări frecvente
De ce în proiectul meu nou nu am eroarea, iar aici da?
Pentru că, fără opțiunea lib, TypeScript include implicit și DOM-ul. În editorul nostru lib e fixat la ES2022, ca într-un proiect de consolă.
De ce pentru window sau localStorage primesc doar „Cannot find name”?
Pentru că sugestia cu lib apare doar pentru câteva nume foarte cunoscute, ca document. Pentru window, localStorage sau HTMLElement vezi TS2304 („Cannot find name 'window'”), dar cauza și reparația sunt aceleași: lipsește dom din lib.
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 TS2550: Property 'toSorted' does not exist on type 'number[]'. Do you need to change your target library? Try changing the 'lib' compiler option to 'es2023' or later. Metoda există în JavaScript, dar în versiunea mai nouă decât cea setată în lib (aici toSorted apare în ES2023, iar proiectul are ES2022). Mărește lib/target în tsconfig, sau folosește o alternativă disponibilă: [...lista].sort() în loc de toSorted(). 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.
