...
Eroare React · State, props și re-randări

Warning: Failed prop type: The prop `pret` is marked as required in `Card`, but its value is `undefined`.

Pe scurt

Componenta Card declară pret ca obligatoriu în propTypes (PropTypes.number.isRequired), dar părintele nu l-a trimis sau i-a trimis undefined. Trimite prop-ul cu numele exact (pret={25}), verifică datele din care vine valoarea sau scoate isRequired dacă prop-ul e opțional și are o valoare implicită.

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

Ce înseamnă

Mesajul vine de la verificarea propTypes din modul de dezvoltare. Bucată cu bucată:

  • Failed prop type – o regulă din Card.propTypes nu a trecut;
  • The prop pret is marked as required in Card – pret este declarat cu .isRequired;
  • but its value is undefined – în props, pret nu există sau e undefined (poate fi și null).

E un avertisment: componenta se randează mai departe, dar de obicei afișează ceva greșit („undefined lei”, „NaN”). Cauzele obișnuite: prop-ul nu e trimis deloc, numele diferă (price în loc de pret, Pret cu literă mare), sau valoarea vine dintr-un obiect care nu are câmpul respectiv ori din date care încă nu s-au încărcat.

Stiva de sub mesaj arată unde e folosit Card: urcă la părinte și vezi ce props îi dai. O variantă înrudită, „Invalid prop pret of type string supplied to Card, expected number”, înseamnă că prop-ul există, dar are alt tip.

De ce apare: cauzele frecvente

1Prop-ul nu e trimis

Greșit
JSX
<Card nume="Cană" />
Corect
JSX
<Card nume="Cană" pret={25} />

Fără pret, valoarea din props este undefined, iar isRequired pică.

2Nume diferit al prop-ului

Greșit
JSX
<Card nume="Cană" price={25} />
Corect
JSX
<Card nume="Cană" pret={25} />

Numele prop-urilor trebuie să fie identice cu cele declarate și folosite în componentă.

3Câmp lipsă în datele primite

Greșit
JSX
const produs = { nume: "Cană", pretul: 25 };
<Card nume={produs.nume} pret={produs.pret} />
Corect
JSX
const produs = { nume: "Cană", pret: 25 };
<Card nume={produs.nume} pret={produs.pret} />

produs.pret nu există dacă obiectul are alt nume de câmp, așa că ajunge undefined în props.

Repară tu

Repară eroarea, direct în pagină

Cardul de mai jos afișează „Cană: undefined lei”, iar consola arată „Failed prop type: The prop pret is marked as required in Card, but its value is undefined”. Repară locul în care e folosit Card (nu componenta), ca paragraful .card să afișeze „Cană: 25 lei”.

Codul care dă eroarea
JSX
import PropTypes from "./prop-types";

function Card({ nume, pret }) {
  return <p className="card">{nume}: {pret} lei</p>;
}

Card.propTypes = {
  nume: PropTypes.string.isRequired,
  pret: PropTypes.number.isRequired,
};

export default function App() {
  return <Card nume="Cană" price={25} />;
}
Indiciu

Uită-te la numele prop-ului trimis din App.

Alte forme ale mesajului

  • Warning: Failed prop type: The prop `nume` is marked as required in `Card`, but its value is `null`.
  • Warning: Failed prop type: Invalid prop `pret` of type `string` supplied to `Card`, expected `number`.
  • Warning: Failed prop type: The prop `children` is marked as required in `Buton`, but its value is `undefined`.
  • Warning: Failed prop type: The prop `onClick` is marked as required in `Buton`, but its value is `undefined`.

Cum o eviți pe viitor

  • Când adaugi un prop obligatoriu, caută toate locurile unde e folosită componenta și trimite-l peste tot.
  • Pentru props opționale, nu pune isRequired; dă-le o valoare implicită în parametri ({ pret = 0 }).
  • Păstrează aceleași nume pentru câmpuri în date și în props (sau mapează-le explicit într-un singur loc).
  • Citește consola în timpul dezvoltării: avertismentele propTypes arată exact componenta și prop-ul.

Întrebări frecvente

De ce nu văd avertismentul în producție?

Verificarea propTypes rulează doar în build-ul de dezvoltare, ca să nu încetinească aplicația. În producție problema rămâne, dar nu mai e semnalată.

Valoarea vine dintr-un fetch și avertismentul apare doar o dată, la început. E grav?

Înseamnă că Card se randează înainte să sosească datele. Afișează componenta doar după încărcare ({produs && <Card ... />}) sau fă prop-ul opțional, cu o valoare implicită.

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.