...
Eroare React · Context și React Router

A <Route> is only ever to be used as the child of <Routes> element, never rendered directly. Please wrap your <Route> in a <Routes>.

Pe scurt

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

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

Ce înseamnă

În React Router v6, <Route> nu mai afișează nimic singur: este doar o descriere a unei rute. Componenta <Routes> citește toți copiii <Route>, alege ruta care se potrivește cu adresa curentă și afișează element-ul ei. Un <Route> pus direct în JSX, fără <Routes> în jur, aruncă eroarea.

Apare aproape mereu în codul scris după tutoriale pentru v5, unde rutele stăteau în <Switch> sau direct în <BrowserRouter> și foloseau component={...}. În v6 forma este <Routes><Route path="/" element={<Acasa />} /></Routes>.

Și rutele imbricate trebuie să fie fie copii ai unui <Route> din <Routes>, fie într-un alt <Routes> în componenta copil.

De ce apare: cauzele frecvente

1Route direct în BrowserRouter (stil v5)

Greșit
JSX
<BrowserRouter>
  <Route path="/" element={<Acasa />} />
  <Route path="/cos" element={<Cos />} />
</BrowserRouter>
Corect
JSX
<BrowserRouter>
  <Routes>
    <Route path="/" element={<Acasa />} />
    <Route path="/cos" element={<Cos />} />
  </Routes>
</BrowserRouter>

Routes alege una dintre rute în funcție de adresă și o afișează.

2Switch din v5 în loc de Routes

Greșit
JSX
import { Switch, Route } from "react-router-dom";
<Switch>
  <Route path="/" component={Acasa} />
</Switch>
Corect
JSX
import { Routes, Route } from "react-router-dom";
<Routes>
  <Route path="/" element={<Acasa />} />
</Routes>

În v6, Switch a devenit Routes, iar component a devenit element, cu JSX.

Repară tu

Repară eroarea, direct în pagină

Rutele de mai jos sunt scrise ca în React Router v5, direct în <BrowserRouter>, iar aplicația aruncă „A <Route> is only ever to be used as the child of <Routes> element”. Repară-le pentru v6, ca la adresa /produse să apară titlul h1 „Produse”.

Codul care dă eroarea
JSX
import { BrowserRouter, Routes, Route } from "react-router-dom";

export default function App() {
  return (
    <BrowserRouter>
      <Route path="/" element={<h1>Acasă</h1>} />
      <Route path="/produse" element={<h1>Produse</h1>} />
    </BrowserRouter>
  );
}
Indiciu

În v6 rutele stau într-un element anume.

Alte forme ale mesajului

  • [Route] is not a <Route> component. All component children of <Routes> must be a <Route> or <React.Fragment>
  • export 'Switch' (imported as 'Switch') was not found in 'react-router-dom'

Cum o eviți pe viitor

  • Verifică versiunea din package.json (react-router-dom) și urmează documentația versiunii respective.
  • Ține toate rutele de nivel înalt într-un singur <Routes>, iar pentru secțiuni folosește rute imbricate și <Outlet />.
  • Pentru legături folosește <Link> / <NavLink>, nu <Route>.
  • Când urmezi un tutorial, verifică versiunea lui: Switch, component= sau exact înseamnă cod scris pentru v5.

Întrebări frecvente

De ce tutorialul meu folosește Switch?

Tutorialul este pentru React Router v5. În v6 (cel din curs) Switch nu mai există: s-a înlocuit cu Routes, iar component={Acasa} cu element={<Acasa />}.

Pot pune Routes de mai multe ori în aplicație?

Da. De exemplu, o componentă Cont poate avea propriul <Routes> pentru subpagini, dacă ruta părinte se termină cu /*. Fiecare Route trebuie însă să fie copilul unui Routes sau al unui alt Route.

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.