ReferenceError: process is not defined
Codul din browser folosește process.env, care există doar în Node și în Create React App. În Vite variabilele de mediu se citesc cu import.meta.env.VITE_NUME, iar numele lor trebuie să înceapă cu VITE_ în fișierul .env. Repornește npm run dev după ce schimbi .env.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
process este un obiect global din Node.js. În browser nu există. Create React App (webpack) înlocuia la build expresii ca process.env.REACT_APP_API_URL cu valoarea lor, așa că părea că process merge și în browser. Vite nu face asta: dacă scrii process.env... într-o componentă, codul ajunge neschimbat în browser și aruncă ReferenceError: process is not defined.
În Vite:
- variabilele se pun în
.env, cu prefixulVITE_:VITE_API_URL=https://api.exemplu.ro; - se citesc cu
import.meta.env.VITE_API_URL; import.meta.env.MODE,DEVșiPRODînlocuiescprocess.env.NODE_ENV.
Eroarea apare des la migrarea de la Create React App la Vite sau la o bibliotecă veche care citește process.env.NODE_ENV. Variabilele fără prefixul VITE_ nu ajung în browser, intenționat, ca secretele să nu fie expuse.
De ce apare: cauzele frecvente
1Variabile din Create React App într-un proiect Vite
// .env: REACT_APP_API_URL=https://api.exemplu.ro
const API_URL = process.env.REACT_APP_API_URL;// .env: VITE_API_URL=https://api.exemplu.ro
const API_URL = import.meta.env.VITE_API_URL;Vite expune în browser doar variabilele cu prefixul VITE_, prin import.meta.env.
2Verificarea modului de lucru
if (process.env.NODE_ENV === "development") {
console.log("debug");
}if (import.meta.env.DEV) {
console.log("debug");
}import.meta.env.DEV este true la npm run dev și false în build-ul de producție.
3Configurare citită în mai multe locuri
fetch(process.env.REACT_APP_API_URL + "/produse");
// ... și în alte 10 fișiere// config.js
export const API_URL = import.meta.env.VITE_API_URL;
// în componente
import { API_URL } from "./config";Citești mediul într-un singur fișier; la o schimbare de unealtă modifici un singur loc.
Repară eroarea, direct în pagină
Componenta de mai jos citește adresa API-ului cu process.env, ca în Create React App, și dă eroarea „process is not defined”. Adresa e deja pusă în fișierul config.js (într-un proiect Vite real, acolo ai scrie import.meta.env.VITE_API_URL). Repar-o ca adresa să vină din config.js, iar după încărcare să apară câte un li pentru fiecare produs.
import { useState, useEffect } from "react";
const API_URL = process.env.REACT_APP_API_URL;
export default function App() {
const [produse, setProduse] = useState([]);
useEffect(() => {
fetch(API_URL + "/produse")
.then((r) => r.json())
.then((date) => setProduse(date));
}, []);
return (
<ul>
{produse.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}Indiciu
Importă API_URL din ./config și scoate process.env.
Reparația
import { useState, useEffect } from "react";
import { API_URL } from "./config";
export default function App() {
const [produse, setProduse] = useState([]);
useEffect(() => {
fetch(API_URL + "/produse")
.then((r) => r.json())
.then((date) => setProduse(date));
}, []);
return (
<ul>
{produse.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}De ce merge
process există doar în Node. Create React App înlocuia process.env.REACT_APP_... la build, dar în browser, fără această înlocuire, process nu e definit, iar prima linie aruncă eroarea înainte ca aplicația să pornească.
Adresa citită dintr-un singur fișier de configurare face componenta independentă de unealta de build. Într-un proiect Vite real, config.js ar conține import.meta.env.VITE_API_URL, iar valoarea ar veni din .env.
Alte forme ale mesajului
Uncaught ReferenceError: process is not definedReferenceError: Can't find variable: processReferenceError: process is not defined at node_modules/.vite/deps/...Cannot find name 'process'. Do you need to install type definitions for node?
Cum o eviți pe viitor
- Într-un proiect Vite, folosește doar
import.meta.envși prefixulVITE_în.env. - Citește variabilele de mediu într-un singur fișier (
config.js) și importă de acolo. - Nu pune secrete (chei private, parole) în variabile
VITE_: ajung în codul trimis browserului. - După orice schimbare în
.env, repornește serverul de dezvoltare.
Întrebări frecvente
Am pus VITE_API_URL în .env, dar import.meta.env.VITE_API_URL e undefined. De ce?
Fie serverul nu a fost repornit după modificarea .env, fie fișierul nu e în rădăcina proiectului (lângă package.json), fie numele diferă. Vite citește .env doar la pornire.
O bibliotecă din node_modules aruncă eroarea. Ce fac?
Biblioteca e gândită pentru webpack. Caută o versiune nouă a ei sau adaugă în vite.config.js define: { "process.env.NODE_ENV": JSON.stringify("production") }.
Erori înrudite
ReferenceError: useState is not defined Folosești useState fără să-l fi importat din "react". Adaugă la începutul fișierului import { useState } from "react"; la fel pentru useEffect, useRef și celelalte hook-uri. TypeError: Failed to fetch Cererea fetch nu a primit niciun răspuns: serverul nu rulează, adresa e greșită (alt port, http/https) sau browserul a blocat-o (CORS). Verifică adresa în tab-ul Network și prinde eroarea cu .catch ca să afișezi un mesaj. Failed to resolve import "./componente/Card" from "src/App.jsx". Does the file exist? Vite nu găsește fișierul pe care îl imporți: calea relativă e greșită (alt folder, ./ lipsă, ../ în plus) sau numele diferă ca litere mari/mici. Verifică unde e fișierul față de cel care îl importă și scrie calea exact, de exemplu import Card from "./Card". Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
