...
Eroare React · Pornirea aplicației, importuri și configurare

ReferenceError: process is not defined

Pe scurt

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 prefixul VITE_: VITE_API_URL=https://api.exemplu.ro;
  • se citesc cu import.meta.env.VITE_API_URL;
  • import.meta.env.MODE, DEV și PROD înlocuiesc process.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

Greșit
JSX
// .env: REACT_APP_API_URL=https://api.exemplu.ro
const API_URL = process.env.REACT_APP_API_URL;
Corect
JSX
// .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

Greșit
JSX
if (process.env.NODE_ENV === "development") {
  console.log("debug");
}
Corect
JSX
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

Greșit
JSX
fetch(process.env.REACT_APP_API_URL + "/produse");
// ... și în alte 10 fișiere
Corect
JSX
// 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ă tu

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.

Codul care dă eroarea
JSX
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.

Alte forme ale mesajului

  • Uncaught ReferenceError: process is not defined
  • ReferenceError: Can't find variable: process
  • ReferenceError: 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 prefixul VITE_ î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

← Toate erorile React

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