...
Eroare React · Context și React Router

useNavigate() may be used only in the context of a <Router> component.

Pe scurt

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

Greșit
JSX
export default function App() {
  const navigate = useNavigate();
  return (
    <BrowserRouter>
      <button onClick={() => navigate("/cos")}>Coș</button>
    </BrowserRouter>
  );
}
Corect
JSX
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

Greșit
JSX
// main.jsx
createRoot(root).render(<App />);
Corect
JSX
// 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ă tu

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”.

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

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 (în main.jsx sau î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

← 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.