...
Eroare JavaScript · Variabile, declarații și strict mode

ReferenceError: document is not defined

Pe scurt

Codul folosește `document` (sau `window`) într-un loc unde nu există pagină web: în Node.js, într-un Web Worker sau la randarea pe server. Rulează codul care lucrează cu pagina doar în browser, în scriptul paginii, și ține logica separat de DOM.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

document și window nu fac parte din limbajul JavaScript, ci sunt oferite de browser, pentru pagina deschisă. Alte medii în care rulează JavaScript nu au pagină, deci nici aceste obiecte:

  • Node.js (scripturi rulate cu node, servere, teste);
  • Web Workers, unde rulează și editorul nostru de JavaScript, ca o aplicație de consolă;
  • randarea pe server în framework-uri ca Next.js, unde componenta rulează întâi pe server.

Când codul ajunge la document.getElementById(...) într-un astfel de mediu, numele document nu există și primești ReferenceError. Același lucru pentru window, localStorage, alert.

Soluția nu e să „definești” document, ci să muți codul de pagină acolo unde există pagina, iar logica (calcule, prelucrări de date) să o păstrezi în funcții care nu depind de DOM și primesc datele ca parametri.

De ce apare: cauzele frecvente

1Script de pagină rulat în Node.js

Greșit
JavaScript
// node script.js
const titlu = document.querySelector("h1");
console.log(titlu.textContent);
Corect
JavaScript
<!-- în index.html, deschis în browser -->
<h1>Salut</h1>
<script>
  const titlu = document.querySelector("h1");
  console.log(titlu.textContent);
</script>

Node nu are pagină. Codul cu document trebuie încărcat de o pagină HTML deschisă în browser.

2Logică amestecată cu DOM-ul

Greșit
JavaScript
function total() {
  const pret = Number(document.getElementById("pret").value);
  return pret * 1.19;
}
Corect
JavaScript
function total(pret) {
  return pret * 1.19;
}
// în pagină: total(Number(input.value))

Funcția care primește valoarea ca parametru merge oriunde: în browser, în Node, în teste, în worker.

3Cod de browser executat la randarea pe server

Greșit
JavaScript
const latime = window.innerWidth; // la nivelul modulului, în Next.js
Corect
JavaScript
useEffect(() => {
  const latime = window.innerWidth;
}, []);

În framework-urile cu randare pe server, codul de browser se pune în locuri care rulează doar în browser (de exemplu useEffect).

Repară tu

Repară eroarea, direct în pagină

Funcția de mai jos calculează prețul cu TVA, dar citește prețul din pagină cu document, iar programul rulează fără pagină: consola arată ReferenceError: document is not defined. Rescrie funcția să primească prețul ca parametru și afișează prețul cu TVA pentru 100 și pentru 250 de lei.

Codul care dă eroarea
JavaScript
function pretCuTva() {
  const pret = Number(document.getElementById("pret").value);
  return pret * 1.19;
}

console.log(pretCuTva().toFixed(2));
console.log(pretCuTva().toFixed(2));
După reparație, programul afișează
119.00
297.50
Indiciu

Funcția nu trebuie să știe de unde vine prețul: primește-l ca parametru.

Alte forme ale mesajului

  • ReferenceError: window is not defined
  • ReferenceError: localStorage is not defined
  • ReferenceError: alert is not defined

Cum o eviți pe viitor

  • Separă logica de interfață: funcții care primesc date și returnează rezultate, plus puțin cod care citește și scrie în pagină.
  • Știi mereu unde rulează codul: pagină, Node, worker sau server.
  • Când un cod trebuie să meargă în mai multe medii, verifică înainte: if (typeof document !== "undefined") { ... }.
  • Pentru teste în Node care au nevoie de DOM, folosește un mediu simulat (jsdom).

Întrebări frecvente

De ce în editorul de lecții nu pot folosi document?

Programele JavaScript din lecții rulează într-un Web Worker, ca o aplicație de consolă, fără pagină. Lecțiile cu pagini web au un editor HTML separat, unde document există.

Pot verifica dacă rulez în browser?

Da: typeof document !== "undefined" este true doar dacă există o pagină. typeof nu aruncă eroare pentru nume nedefinite.

Erori înrudite

← Toate erorile JavaScript

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ță JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.