...
Eroare Node.js · Module CommonJS: require și module.exports

ReferenceError: window is not defined

Pe scurt

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

Greșit
JavaScript
window.contor = 0;
window.contor++;
console.log(window.contor);
Corect
JavaScript
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

Greșit
JavaScript
window.localStorage.setItem("tema", "dark");
Corect
JavaScript
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

Greșit
JavaScript
const latime = window.innerWidth;
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
window.vizite = 0;

function inregistreazaVizita(pagina) {
  window.vizite++;
  console.log(`Vizită pe ${pagina} (total: ${window.vizite})`);
}

inregistreazaVizita("/");
inregistreazaVizita("/cursuri");
inregistreazaVizita("/contact");
După reparație, programul afișează
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.

Alte forme ale mesajului

  • ReferenceError: document is not defined
  • ReferenceError: localStorage is not defined
  • ReferenceError: alert is not defined
  • ReferenceError: 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

← Toate erorile Node.js

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ță 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.