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

error TS2584: Cannot find name 'document'. Do you need to change your target library? Try changing the 'lib' compiler option to include 'dom'.

Pe scurt

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

Greșit
TypeScript
// tsconfig.json: "lib": ["es2022"]
document.title = "Magazin";
Corect
TypeScript
// tsconfig.json: "lib": ["es2022", "dom", "dom.iterable"]
document.title = "Magazin";

Cu dom în lib, tipurile browserului sunt disponibile.

2Cod de browser rulat în consolă

Greșit
TypeScript
const total = 120;
document.getElementById("total")!.textContent = `${total} lei`;
Corect
TypeScript
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

Greșit
TypeScript
window.setTimeout(() => console.log("gata"), 10);
Corect
TypeScript
setTimeout(() => console.log("gata"), 10);

setTimeout există și fără DOM; nu ai nevoie de window în față (care aici ar da TS2304).

Repară tu

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.

Codul care dă eroarea
TypeScript
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;
După reparație, programul afișează
Coș: 3 produse, 74.50 lei
Indiciu

Păstrează textul calculat și trimite-l la console.log în loc de document.body.textContent.

Alte forme ale mesajului

  • error TS2304: Cannot find name 'window'.
  • error TS2304: Cannot find name 'HTMLElement'.

Cum o eviți pe viitor

  • Alege lib după unde rulează codul: dom pentru browser, @types/node pentru 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: any ca 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

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