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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Hook-urile din React Router (useNavigate, useLocation, useParams, useSearchParams) citesc informația despre adresa curentă dintr-un context creat de <BrowserRouter> (sau MemoryRouter, RouterProvider). Dacă componenta nu se află în interiorul router-ului, contextul lipsește, iar React Router aruncă useNavigate() may be used only in the context of a <Router> component.
Greșeala clasică: chiar componenta App apelează useNavigate() și tot ea randează <BrowserRouter> în JSX-ul ei. Router-ul este copilul lui App, nu părintele, deci la momentul apelului nu există încă.
Apare și în teste, când randezi o componentă cu useNavigate fără să o învelești într-un MemoryRouter.
De ce apare: cauzele frecvente
1Hook apelat în componenta care randează router-ul
export default function App() {
const navigate = useNavigate();
return (
<BrowserRouter>
<button onClick={() => navigate("/cos")}>Coș</button>
</BrowserRouter>
);
}function Meniu() {
const navigate = useNavigate();
return <button onClick={() => navigate("/cos")}>Coș</button>;
}
export default function App() {
return (
<BrowserRouter>
<Meniu />
</BrowserRouter>
);
}Meniu este randat în interiorul router-ului, deci contextul există când apelează hook-ul.
2Router mutat în main.jsx
// main.jsx
createRoot(root).render(<App />);// main.jsx
createRoot(root).render(
<BrowserRouter>
<App />
</BrowserRouter>
);Cu router-ul deasupra lui App, toate componentele, inclusiv App, pot folosi hook-urile de rutare.
Repară eroarea, direct în pagină
App de mai jos apelează useNavigate() și tot ea randează <BrowserRouter>, așa că aplicația aruncă „useNavigate() may be used only in the context of a <Router> component”. Mută butonul #spre-cos și hook-ul într-o componentă Meniu randată în router, ca după click adresa să fie /cos, iar titlul h1 „Coșul tău”.
import { BrowserRouter, Routes, Route, useNavigate } from "react-router-dom";
export default function App() {
const navigate = useNavigate();
return (
<BrowserRouter>
<button id="spre-cos" onClick={() => navigate("/cos")}>Coș</button>
<Routes>
<Route path="/" element={<h1>Produse</h1>} />
<Route path="/cos" element={<h1>Coșul tău</h1>} />
</Routes>
</BrowserRouter>
);
}Indiciu
Componenta care apelează useNavigate trebuie să fie în interiorul lui BrowserRouter.
Reparația
import { BrowserRouter, Routes, Route, useNavigate } from "react-router-dom";
function Meniu() {
const navigate = useNavigate();
return <button id="spre-cos" onClick={() => navigate("/cos")}>Coș</button>;
}
export default function App() {
return (
<BrowserRouter>
<Meniu />
<Routes>
<Route path="/" element={<h1>Produse</h1>} />
<Route path="/cos" element={<h1>Coșul tău</h1>} />
</Routes>
</BrowserRouter>
);
}De ce merge
useNavigate citește contextul creat de <BrowserRouter>. În starter, App apelează hook-ul înainte să randeze router-ul, iar router-ul este copilul lui App, deci contextul nu există încă și React Router aruncă eroarea.
Meniu este randat în interiorul <BrowserRouter>, așa că, atunci când apelează useNavigate, contextul există. Click-ul schimbă adresa în /cos, iar Routes afișează pagina coșului.
Alte forme ale mesajului
useLocation() may be used only in the context of a <Router> component.useHref() may be used only in the context of a <Router> component.You cannot render a <Router> inside another <Router>. You should never have more than one in your app.
Cum o eviți pe viitor
- Pune
<BrowserRouter>o singură dată, cât mai sus (înmain.jsxsau în jurul întregii aplicații). - Nu apela hook-uri de rutare în componenta care creează router-ul.
- În teste învelește componenta în
<MemoryRouter initialEntries={["/"]}>. - Dacă o componentă are nevoie de navigare, verifică în arbore (React DevTools) că se află sub router.
Întrebări frecvente
Același mesaj apare pentru useLocation. E aceeași cauză?
Da. Toate hook-urile React Router au nevoie de un router deasupra; mesajul diferă doar prin numele hook-ului.
Pot avea mai multe BrowserRouter-e?
Nu e recomandat; un router în alt router aruncă „You cannot render a <Router> inside another <Router>”. Folosește unul singur pentru toată aplicația și rute imbricate pentru secțiuni.
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>. TypeError: Cannot destructure property 'tema' of 'useContext(...)' as it is undefined. Componenta citește un Context care nu are un Provider deasupra ei, iar createContext() fără valoare implicită dă undefined. Învelește arborele în <TemaContext.Provider value={...}> sau dă contextului o valoare implicită. 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. Î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.
