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.
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
export default function App() {
const [n, setN] = useState(0);
...
}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
import { useState } from "react";
...
useEffect(() => { ... }, []);import { useState, useEffect } from "react";
...
useEffect(() => { ... }, []);Fiecare hook folosit trebuie să apară în lista de importuri.
3Import din pachetul greșit
import { useState } from "react-dom";import { useState } from "react";Hook-urile vin din react; react-dom conține doar funcțiile de montare în pagină.
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”.
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.
Reparația
import { useState } from "react";
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>
);
}De ce merge
Fiecare fișier JavaScript are propriul spațiu de nume. useState este exportat de pachetul react, dar nu ajunge automat în fișierul tău, deci la prima randare JavaScript nu găsește numele și aruncă ReferenceError.
import { useState } from "react"; aduce funcția în fișier. Din acel moment apelul din componentă funcționează, iar contorul pornește de la 0 și crește la click.
Alte forme ale mesajului
ReferenceError: useEffect is not definedReferenceError: React is not defined'useState' is not defined no-undefCannot 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-undefsemnalează î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
Invalid hook call. Hooks can only be called inside of the body of a function component. Ai apelat un hook (useState, useEffect, useContext...) în afara corpului unei componente funcție: într-un handler, într-o funcție obișnuită sau într-o clasă. Mută apelul la începutul componentei. TypeError: setAprecieri is not a function Variabila pe care o apelezi ca setter nu este o funcție, cel mai des pentru că ai destructurat useState cu acolade ({ x, setX }) în loc de paranteze drepte ([x, setX]), ori setter-ul nu a fost trimis ca prop. Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: undefined. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports. Componenta pe care o folosești în JSX este undefined, de obicei pentru că ai importat-o cu acolade deși e exportată cu export default (sau invers), ori ai uitat să o exporți. Potrivește importul cu exportul. Î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.
