ReferenceError: document is not defined
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
// node script.js
const titlu = document.querySelector("h1");
console.log(titlu.textContent);<!-- î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
function total() {
const pret = Number(document.getElementById("pret").value);
return pret * 1.19;
}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
const latime = window.innerWidth; // la nivelul modulului, în Next.jsuseEffect(() => {
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ă 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.
function pretCuTva() {
const pret = Number(document.getElementById("pret").value);
return pret * 1.19;
}
console.log(pretCuTva().toFixed(2));
console.log(pretCuTva().toFixed(2));119.00 297.50
Indiciu
Funcția nu trebuie să știe de unde vine prețul: primește-l ca parametru.
Reparația
function pretCuTva(pret) {
return pret * 1.19;
}
console.log(pretCuTva(100).toFixed(2));
console.log(pretCuTva(250).toFixed(2));De ce merge
document există doar într-o pagină web deschisă în browser; aici codul rulează ca un program de consolă, deci numele nu e definit. Mutând citirea prețului în afara funcției, funcția devine pură: primește un număr și returnează un număr, așa că merge oriunde. Într-o pagină, ai apela-o cu pretCuTva(Number(input.value)).
Alte forme ale mesajului
ReferenceError: window is not definedReferenceError: localStorage is not definedReferenceError: 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
ReferenceError: pret is not defined Folosești un nume (variabilă sau funcție) pe care JavaScript nu îl găsește nicăieri în locul acela: nu a fost declarat, e scris diferit (literele mari contează) sau a fost declarat în alt bloc ori în altă funcție. Declară-l cu `const`/`let` sau corectează numele. TypeError: Cannot read properties of null (reading 'textContent') Citești o proprietate dintr-o valoare `null`. În browser, aproape mereu e un element pe care `document.querySelector` sau `getElementById` nu l-a găsit (selector greșit sau script rulat înainte ca elementul să existe). În rest, o funcție sau o metodă a returnat `null` intenționat: verifică rezultatul înainte să îl folosești. Î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.
