'nume' is missing in props validation
Regula ESLint react/prop-types cere ca fiecare prop folosit într-o componentă să fie declarat în Componenta.propTypes. Fie declari tipurile (Card.propTypes = { nume: PropTypes.string.isRequired }), fie, dacă folosești TypeScript sau nu vrei prop-types, dezactivezi regula în configurația ESLint.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la ESLint, regula react/prop-types, inclusă în plugin:react/recommended (era în șablonul de proiect Vite + React și în multe configurații). Regula vede că o componentă folosește props.nume sau { nume } din props și nu găsește nume declarat în Card.propTypes.
PropTypes este un sistem de verificare a tipurilor la rulare, din pachetul prop-types: în modul de dezvoltare, React verifică valorile primite și scrie în consolă „Failed prop type” când un prop lipsește sau are alt tip. Codul merge și fără, dar regula te obligă să documentezi ce primește fiecare componentă.
Ai două drumuri:
- declari propTypes pentru toate props-urile folosite, inclusiv
childrenși funcțiile (onClick); - renunți la regulă dacă proiectul folosește TypeScript (tipurile din TS fac aceeași treabă, la compilare) sau dacă echipa a decis să nu folosească prop-types:
"react/prop-types": "off"în configurația ESLint.
React 19 nu mai verifică propTypes, de aceea proiectele noi preferă TypeScript.
De ce apare: cauzele frecvente
1Prop folosit, dar nedeclarat
function Card({ nume, pret }) {
return <p>{nume}: {pret} lei</p>;
}import PropTypes from "prop-types";
function Card({ nume, pret }) {
return <p>{nume}: {pret} lei</p>;
}
Card.propTypes = {
nume: PropTypes.string.isRequired,
pret: PropTypes.number,
};Fiecare prop folosit are acum un tip declarat, iar regula nu mai are ce semnala.
2children și funcțiile uitate
function Buton({ children, onClick }) {
return <button onClick={onClick}>{children}</button>;
}
Buton.propTypes = {};Buton.propTypes = {
children: PropTypes.node.isRequired,
onClick: PropTypes.func,
};Regula verifică toate props-urile, inclusiv children și handler-ele trimise de părinte.
3Proiect cu TypeScript sau fără prop-types
// eslint.config.js
rules: {}
// apare 'nume' is missing in props validation peste tot// eslint.config.js
rules: {
"react/prop-types": "off",
}Dacă tipurile vin din TypeScript sau echipa nu folosește prop-types, regula nu mai aduce nimic și se dezactivează explicit.
Repară eroarea, direct în pagină
Componenta Card de mai jos merge, dar ESLint spune „'nume' is missing in props validation” (și la fel pentru pret). În acest mediu, prop-types e în fișierul ./prop-types. Declară Card.propTypes: nume text obligatoriu și pret număr. Pagina trebuie să afișeze în continuare „Cană: 25 lei”.
import PropTypes from "./prop-types";
function Card({ nume, pret }) {
return <p className="card">{nume}: {pret} lei</p>;
}
export default function App() {
return <Card nume="Cană" pret={25} />;
}Indiciu
Card.propTypes = { nume: PropTypes.string.isRequired, pret: PropTypes.number };
Reparația
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,
};
export default function App() {
return <Card nume="Cană" pret={25} />;
}De ce merge
Regula react/prop-types căuta în Card.propTypes fiecare prop folosit de componentă și nu găsea nici nume, nici pret.
Cu Card.propTypes declarat, regula e mulțumită, iar React verifică în modul de dezvoltare valorile primite: dacă cineva uită nume sau trimite prețul ca text, consola arată „Failed prop type”. Pagina arată la fel, pentru că propTypes nu schimbă randarea.
Alte forme ale mesajului
'nume' is missing in props validation react/prop-types'children' is missing in props validation'onClick' is missing in props validation'produs.nume' is missing in props validation
Cum o eviți pe viitor
- Decide la începutul proiectului: prop-types, TypeScript sau niciuna, și configurează ESLint pe măsură.
- Dacă folosești prop-types, scrie
Componenta.propTypesimediat după componentă, odată cu props-urile noi. - Marchează cu
.isRequiredprops-urile fără de care componenta nu are sens. - Pentru obiecte, descrie forma lor cu
PropTypes.shape({ ... }), ca să fie verificate și câmpurile.
Întrebări frecvente
Trebuie să instalez ceva?
Da, pachetul separat: npm install prop-types, apoi import PropTypes from "prop-types". Nu mai face parte din React din versiunea 15.5.
Am TypeScript și tot primesc mesajul. De ce?
Configurația ESLint folosește plugin:react/recommended, care activează regula. Pentru fișierele .tsx, dezactiveaz-o ("react/prop-types": "off"): tipurile TS fac deja verificarea.
Erori înrudite
Warning: Failed prop type: The prop `pret` is marked as required in `Card`, but its value is `undefined`. 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ă. Warning: Card: Support for defaultProps will be removed from function components in a future major release. Use JavaScript default parameters instead. Componenta funcție Card folosește Card.defaultProps, pe care React 18.3 îl marchează ca învechit (în React 19 nu mai funcționează pentru funcții). Scoate defaultProps și pune valorile implicite direct în parametri: function Card({ nume = "Anonim", pret = 0 }). Warning: Rand: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. Componenta încearcă să citească props.key, dar key este rezervat pentru React și nu ajunge niciodată în props. Trimite valoarea printr-un prop separat, de exemplu id={p.id} sau cod={p.cod}. Î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.
