ReferenceError: window is not defined
Rulezi în Node cod scris pentru browser: în Node nu există window, document sau localStorage. Folosește echivalentele din Node (globalThis, process, fs) sau rulează codul acela doar în browser.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
window este obiectul global al browserului: ferestrele, location, alert, localStorage. Node nu are fereastră, așa că variabila window pur și simplu nu există, iar orice folosire a ei dă ReferenceError.
Eroarea apare când copiezi un exemplu de pe un site scris pentru browser, când un fișier e folosit și în pagină și pe server, sau în aplicații cu randare pe server (Next.js, Nuxt), unde același cod rulează întâi în Node. Obiectul global din Node este global, iar varianta care merge în ambele medii este globalThis.
Linia din mesaj arată unde ai folosit window. Întreabă-te ce voiai să obții de acolo: o variabilă globală, adresa paginii, o setare salvată, și caută echivalentul din Node.
De ce apare: cauzele frecvente
1Variabile globale prin window
window.contor = 0;
window.contor++;
console.log(window.contor);globalThis.contor = 0;
globalThis.contor++;
console.log(globalThis.contor);globalThis este obiectul global în orice mediu: window în browser, global în Node.
2localStorage pentru date salvate
window.localStorage.setItem("tema", "dark");const fs = require("fs");
fs.writeFileSync("setari.json", JSON.stringify({ tema: "dark" }));În Node datele se salvează în fișiere sau într-o bază de date, nu în stocarea browserului.
3Cod care rulează în ambele medii
const latime = window.innerWidth;const latime = typeof window !== "undefined" ? window.innerWidth : 1024;typeof nu aruncă eroare pentru variabile inexistente, deci poți verifica sigur dacă ești în browser.
Repară eroarea, direct în pagină
Codul de mai jos a fost copiat dintr-un script de browser și dă ReferenceError: window is not defined în Node. Înlocuiește window cu obiectul global care există și în Node, ca programul să numere vizitele și să afișeze contorul.
window.vizite = 0;
function inregistreazaVizita(pagina) {
window.vizite++;
console.log(`Vizită pe ${pagina} (total: ${window.vizite})`);
}
inregistreazaVizita("/");
inregistreazaVizita("/cursuri");
inregistreazaVizita("/contact");Vizită pe / (total: 1) Vizită pe /cursuri (total: 2) Vizită pe /contact (total: 3)
Indiciu
Obiectul global care există în orice mediu se numește globalThis.
Reparația
globalThis.vizite = 0;
function inregistreazaVizita(pagina) {
globalThis.vizite++;
console.log(`Vizită pe ${pagina} (total: ${globalThis.vizite})`);
}
inregistreazaVizita("/");
inregistreazaVizita("/cursuri");
inregistreazaVizita("/contact");De ce merge
În browser, window este obiectul global, iar în Node obiectul global se numește global. globalThis e numele standard care merge în ambele medii, deci codul rulează la fel peste tot. O variantă și mai curată ar fi o variabilă obișnuită let vizite = 0; în modul, pentru că proprietățile globale pot fi modificate din orice fișier și sunt greu de urmărit.
Alte forme ale mesajului
ReferenceError: document is not definedReferenceError: localStorage is not definedReferenceError: alert is not definedReferenceError: navigator is not defined
Cum o eviți pe viitor
- Separă codul de browser (DOM,
window,document) de codul de server. - Pentru variabile globale folosește
globalThis, sau mai bine evită-le și exportă valori din module. - În framework-uri cu randare pe server, pune codul de browser în locurile care rulează doar în browser (de exemplu
useEffectîn React). - Când copiezi un exemplu, verifică dacă e scris pentru Node sau pentru browser.
Întrebări frecvente
Node are un echivalent pentru window?
Obiectul global din Node se numește global. globalThis funcționează și în Node și în browser, deci e alegerea sigură.
Cum afișez ceva fără alert?
În Node folosești console.log pentru afișare și readline sau process.argv pentru date de la utilizator.
Erori înrudite
Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
