...
Eroare React · Context și React Router

TypeError: Cannot read properties of undefined (reading 'params')

Pe scurt

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 de history.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

Greșit
JSX
function Produs(props) {
  return <h1>Produsul {props.match.params.id}</h1>;
}
Corect
JSX
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

Greșit
JSX
function Login(props) {
  function intra() {
    props.history.push("/cont");
  }
}
Corect
JSX
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

Greșit
JSX
<Route path="/produse/:id" component={Produs} />
Corect
JSX
<Route path="/produse/:id" element={<Produs />} />

v6 folosește element și ignoră component, deci pagina ar rămâne goală.

Repară tu

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

Codul care dă eroarea
JSX
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();

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 și withRouter.

Î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

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