...
Eroare React · Regulile hook-urilor

ReferenceError: useState is not defined

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

ReferenceError înseamnă că JavaScript a dat peste un nume care nu există în acel fișier. Hook-urile nu sunt variabile globale: fiecare fișier care le folosește trebuie să le importe din pachetul react.

Apare des când copiezi o componentă dintr-un fișier în altul fără importuri, când adaugi un hook nou (de exemplu useEffect) într-o componentă care avea doar useState importat sau când scrii React.useState într-un loc și useState în altul.

Numele din mesaj este exact ce lipsește (useState, useEffect, useRef, useContext). Varianta cu „React is not defined” apare în proiectele configurate cu transformarea JSX veche, unde fiecare fișier cu JSX avea nevoie de import React from "react".

De ce apare: cauzele frecvente

1Hook folosit fără import

Greșit
JSX
export default function App() {
  const [n, setN] = useState(0);
  ...
}
Corect
JSX
import { useState } from "react";

export default function App() {
  const [n, setN] = useState(0);
  ...
}

Importul aduce funcția useState din pachetul react în fișierul curent.

2Hook nou adăugat, import vechi

Greșit
JSX
import { useState } from "react";
...
useEffect(() => { ... }, []);
Corect
JSX
import { useState, useEffect } from "react";
...
useEffect(() => { ... }, []);

Fiecare hook folosit trebuie să apară în lista de importuri.

3Import din pachetul greșit

Greșit
JSX
import { useState } from "react-dom";
Corect
JSX
import { useState } from "react";

Hook-urile vin din react; react-dom conține doar funcțiile de montare în pagină.

Repară tu

Repară eroarea, direct în pagină

Contorul de vizitatori de mai jos aruncă „useState is not defined” chiar la încărcare. Repară fișierul ca #vizite să afișeze „Vizite: 0”, iar după un click pe #plus „Vizite: 1”.

Codul care dă eroarea
JSX
export default function App() {
  const [vizite, setVizite] = useState(0);

  return (
    <div>
      <p id="vizite">Vizite: {vizite}</p>
      <button id="plus" onClick={() => setVizite((v) => v + 1)}>+1</button>
    </div>
  );
}
Indiciu

Hook-urile se importă din pachetul react.

Alte forme ale mesajului

  • ReferenceError: useEffect is not defined
  • ReferenceError: React is not defined
  • 'useState' is not defined no-undef
  • Cannot find name 'useState'.

Cum o eviți pe viitor

  • Lasă editorul să adauge importurile automat (în VS Code apare sugestia „Add import from react”).
  • Când copiezi o componentă, copiază și liniile de import de sus.
  • ESLint cu regula no-undef semnalează în editor orice nume neimportat, înainte să rulezi.

Întrebări frecvente

Pot scrie React.useState în loc de import?

Da, dacă ai import React from "react". Funcționează la fel; importul cu nume ({ useState }) este doar forma mai scurtă și mai folosită.

De ce eroarea apare doar la randare, nu la încărcarea fișierului?

Pentru că numele useState este căutat abia când rulează funcția componentei. Fișierul se încarcă, dar prima randare se oprește la linia cu hook-ul.

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.