export 'useHistory' (imported as 'useHistory') was not found in 'react-router-dom'
useHistory exista în React Router v5 și a fost scos în v6. În v6 navighezi cu useNavigate: const navigate = useNavigate(); navigate("/cos") în loc de history.push("/cos"). Același lucru pentru Switch (devenit Routes) și Redirect (devenit Navigate).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la bundler (webpack, în Create React App): ai importat un nume pe care pachetul react-router-dom instalat nu îl mai exportă. useHistory a fost înlocuit în React Router v6 cu useNavigate. Codul compilează cu avertisment, dar la rulare useHistory este undefined, iar apelul lui dă „useHistory is not a function”.
Se întâmplă când urmezi un tutorial scris pentru v5 într-un proiect nou, care instalează v6 sau mai nou. Corespondențe utile:
useHistory()+history.push("/x")devineuseNavigate()+navigate("/x");history.replace("/x")devinenavigate("/x", { replace: true });history.goBack()devinenavigate(-1);<Switch>devine<Routes>,<Redirect>devine<Navigate>.
Versiunea instalată o vezi în package.json, la react-router-dom.
De ce apare: cauzele frecvente
1Navigare cu history.push
import { useHistory } from "react-router-dom";
const history = useHistory();
history.push("/cos");import { useNavigate } from "react-router-dom";
const navigate = useNavigate();
navigate("/cos");În v6, useNavigate întoarce direct funcția de navigare.
2Înapoi și înlocuire
history.goBack();
history.replace("/login");navigate(-1);
navigate("/login", { replace: true });navigate acceptă un număr pentru istoric și opțiunea replace.
3Redirect din v5
import { Redirect } from "react-router-dom";
if (!user) return <Redirect to="/login" />;import { Navigate } from "react-router-dom";
if (!user) return <Navigate to="/login" replace />;Redirect a fost înlocuit de componenta Navigate.
Repară eroarea, direct în pagină
Butonul de mai jos ar trebui să ducă la coș, dar codul folosește useHistory din React Router v5 și dă eroarea „useHistory is not a function”. Rescrie-l pentru React Router v6 ca, după click pe #spre-cos, adresa să fie /cos și să apară titlul „Coșul tău”.
import { BrowserRouter, Routes, Route, useHistory } from "react-router-dom";
function Acasa() {
const history = useHistory();
return <button id="spre-cos" onClick={() => history.push("/cos")}>Vezi coșul</button>;
}
export default function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/" element={<Acasa />} />
<Route path="/cos" element={<h1>Coșul tău</h1>} />
</Routes>
</BrowserRouter>
);
}Indiciu
În v6, useNavigate întoarce funcția navigate.
Reparația
import { BrowserRouter, Routes, Route, useNavigate } from "react-router-dom";
function Acasa() {
const navigate = useNavigate();
return <button id="spre-cos" onClick={() => navigate("/cos")}>Vezi coșul</button>;
}
export default function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/" element={<Acasa />} />
<Route path="/cos" element={<h1>Coșul tău</h1>} />
</Routes>
</BrowserRouter>
);
}De ce merge
React Router v6 nu mai exportă useHistory. Importul dă undefined, iar apelul useHistory() aruncă „is not a function” chiar la randarea paginii de start.
În v6, useNavigate() întoarce o funcție: navigate("/cos") face ce făcea history.push("/cos"). Routerul schimbă adresa în /cos, iar Routes afișează ruta potrivită, cu titlul coșului.
Alte forme ale mesajului
TypeError: (0 , react_router_dom__WEBPACK_IMPORTED_MODULE_1__.useHistory) is not a functionSyntaxError: The requested module '/node_modules/.vite/deps/react-router-dom.js?v=8c1f2a3b' does not provide an export named 'useHistory'TypeError: (0 , _reactRouterDom.useHistory) is not a functionexport 'Redirect' (imported as 'Redirect') was not found in 'react-router-dom'Module '"react-router-dom"' has no exported member 'useHistory'.
Cum o eviți pe viitor
- Verifică versiunea React Router din
package.jsonînainte să urmezi un tutorial; caută materiale pentru aceeași versiune majoră. - În v6+ folosește
useNavigate,Routes,Navigateșielement={<Pagina />}. - La migrarea unui proiect vechi, caută în tot codul
useHistory,Switch,Redirectșicomponent=și înlocuiește-le pe toate.
Întrebări frecvente
Pot instala v5 ca să meargă tutorialul?
Poți (npm install react-router-dom@5), dar v5 nu mai e dezvoltat și nu se potrivește cu documentația actuală. Mai bine înveți direct API-ul v6, care e și mai simplu.
De ce Vite dă alt mesaj?
Vite încarcă modulele direct în browser, iar browserul raportează că modulul nu are exportul cerut („does not provide an export named”). Cauza și reparația sunt aceleași.
Erori înrudite
A <Route> is only ever to be used as the child of <Routes> element, never rendered directly. Please wrap your <Route> in a <Routes>. În React Router v6 fiecare <Route> trebuie pus direct în <Routes> (fostul <Switch> din v5). Învelește rutele în <Routes>...</Routes>, în interiorul lui <BrowserRouter>. useNavigate() may be used only in the context of a <Router> component. Componenta care apelează useNavigate (sau useLocation, useParams) nu se află în interiorul unui <BrowserRouter>. Mută router-ul mai sus (în jurul lui App) sau mută hook-ul într-o componentă randată în router. 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.
