TypeError: Cannot read properties of undefined (reading 'params')
Componenta citește props.match.params, ca în React Router v5. În v6, rutele nu mai trimit match, location sau history prin props, deci props.match e undefined. Citește parametrii din adresă cu hook-ul useParams(): const { id } = useParams();.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În React Router v5, o componentă dată unei rute (<Route path="/produse/:id" component={Produs} />) primea automat props-urile match, location și history. Parametrii adresei erau în props.match.params.id.
React Router v6 a schimbat asta: rutele primesc un element (element={<Produs />}), iar componenta nu mai primește nimic automat. props.match este undefined, iar citirea .params aruncă eroarea. Același lucru se întâmplă cu props.location.pathname („reading 'pathname'”) și props.history.push („reading 'push'”).
Echivalentele din v6 sunt hook-uri:
useParams()pentru parametri (const { id } = useParams());useLocation()pentru adresa curentă;useNavigate()pentru navigare (în loc dehistory.push);useSearchParams()pentru?pagina=2.
Eroarea apare tipic când urmezi un tutorial vechi sau migrezi un proiect de la v5. Verifică versiunea din package.json: "react-router-dom": "^6..." înseamnă API-ul cu hook-uri.
De ce apare: cauzele frecvente
1props.match din React Router v5
function Produs(props) {
return <h1>Produsul {props.match.params.id}</h1>;
}import { useParams } from "react-router-dom";
function Produs() {
const { id } = useParams();
return <h1>Produsul {id}</h1>;
}useParams citește parametrii rutei curente, fără să depindă de props.
2props.history pentru navigare
function Login(props) {
function intra() {
props.history.push("/cont");
}
}function Login() {
const navigate = useNavigate();
function intra() {
navigate("/cont");
}
}În v6, navigarea se face cu funcția întoarsă de useNavigate.
3Ruta scrisă în stilul v5
<Route path="/produse/:id" component={Produs} /><Route path="/produse/:id" element={<Produs />} />v6 folosește element și ignoră component, deci pagina ar rămâne goală.
Repară eroarea, direct în pagină
Pagina de produs de mai jos citește id-ul cu props.match.params.id, ca în React Router v5, și dă „TypeError: Cannot read properties of undefined (reading 'params')”. Repar-o cu hook-ul potrivit din v6, ca la adresa /produse/7 titlul h1 să afișeze „Produsul 7”.
import { BrowserRouter, Routes, Route, useParams } from "react-router-dom";
function Produs(props) {
return <h1>Produsul {props.match.params.id}</h1>;
}
export default function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/produse/:id" element={<Produs />} />
</Routes>
</BrowserRouter>
);
}Indiciu
const { id } = useParams();
Reparația
import { BrowserRouter, Routes, Route, useParams } from "react-router-dom";
function Produs() {
const { id } = useParams();
return <h1>Produsul {id}</h1>;
}
export default function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/produse/:id" element={<Produs />} />
</Routes>
</BrowserRouter>
);
}De ce merge
În React Router v6, <Route element={<Produs />}> randează componenta fără niciun prop special. props.match nu există, deci citirea .params pe undefined oprea pagina.
useParams() întoarce parametrii rutei curente ca obiect: pentru /produse/:id și adresa /produse/7, { id: "7" }. Componenta nu mai depinde de props, iar titlul afișează id-ul din adresă.
Alte forme ale mesajului
TypeError: Cannot read properties of undefined (reading 'pathname')TypeError: Cannot read properties of undefined (reading 'push')TypeError: undefined is not an object (evaluating 'props.match.params')TypeError: Cannot read property 'params' of undefined
Cum o eviți pe viitor
- Verifică versiunea React Router din
package.jsonînainte să urmezi un tutorial. - În v6 folosește hook-urile:
useParams,useLocation,useNavigate,useSearchParams. - Nu te baza pe props injectate de rute; rutele v6 nu mai injectează nimic.
- La migrare, caută în proiect
props.match,props.historyșiwithRouter.
Întrebări frecvente
Cum aflu ce versiune de React Router am?
În package.json, la react-router-dom. Sau rulează npm ls react-router-dom. Versiunile 6 și 7 folosesc hook-uri și element.
Am o componentă clasă. Cum folosesc useParams?
Hook-urile nu merg în clase. Scrie o componentă funcție mică, care citește useParams() și randează clasa cu parametrii ca props: <ProdusClasa id={id} />.
Erori înrudite
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). Matched leaf route at location "/cont" does not have an element or Component. This means it will render an <Outlet /> with a null value by default resulting in an "empty" page. Adresa se potrivește cu o rută care nu are element (sau Component), așa că pagina rămâne goală. Cauza tipică e sintaxa din React Router v5: component={Cont} sau render={...}. În v6, ruta primește un element JSX: <Route path="/cont" element={<Cont />} />. 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. Î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.
