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

'nume' is missing in props validation

Pe scurt

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

Greșit
JSX
function Card({ nume, pret }) {
  return <p>{nume}: {pret} lei</p>;
}
Corect
JSX
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

Greșit
JSX
function Buton({ children, onClick }) {
  return <button onClick={onClick}>{children}</button>;
}
Buton.propTypes = {};
Corect
JSX
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

Greșit
JSX
// eslint.config.js
rules: {}
// apare 'nume' is missing in props validation peste tot
Corect
JSX
// 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ă tu

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

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

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.propTypes imediat după componentă, odată cu props-urile noi.
  • Marchează cu .isRequired props-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

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