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

Must use destructuring props assignment

Pe scurt

Regula ESLint react/destructuring-assignment (din configurația Airbnb) cere să scoți valorile din props prin destructurare, nu să scrii props.titlu peste tot. Scrie function Card({ titlu, pret }) și folosește direct titlu și pret.

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

Ce înseamnă

Mesajul vine de la regula react/destructuring-assignment din eslint-plugin-react, activă implicit în configurația Airbnb și în multe proiecte de firmă. Ea nu semnalează o eroare de rulare: codul cu props.titlu merge. Regula impune un stil: valorile din props (și din state sau context la clase) se citesc o singură dată, prin destructurare.

Avantaje: vezi din prima linie ce props folosește componenta, poți da valori implicite ({ pret = 0 }) și eviți să scrii props. de zeci de ori. ESLint indică linia fiecărui props.ceva.

La componente clasă, aceeași regulă cere const { titlu } = this.props; în render(). Dacă echipa preferă stilul invers, regula se poate configura cu "never", dar într-un proiect existent urmezi ce e setat.

De ce apare: cauzele frecvente

1props.ceva în componentă funcție

Greșit
JSX
function Card(props) {
  return <h3>{props.titlu}</h3>;
}
Corect
JSX
function Card({ titlu }) {
  return <h3>{titlu}</h3>;
}

Destructurarea în parametri arată din prima linie ce primește componenta.

2this.props în clasă

Greșit
JSX
render() {
  return <h3>{this.props.titlu}</h3>;
}
Corect
JSX
render() {
  const { titlu } = this.props;
  return <h3>{titlu}</h3>;
}

Regula se aplică și la clase: destructurezi la începutul lui render().

3Ai nevoie și de restul props

Greșit
JSX
function Buton(props) {
  return <button className="btn" {...props}>{props.eticheta}</button>;
}
Corect
JSX
function Buton({ eticheta, ...rest }) {
  return <button className="btn" {...rest}>{eticheta}</button>;
}

Cu ...rest păstrezi celelalte props pentru spread, fără să mai scrii props..

Repară tu

Repară eroarea, direct în pagină

Componenta Card de mai jos citește valorile cu props.titlu și props.pret, iar ESLint raportează „Must use destructuring props assignment”. Rescrie-o cu destructurare în parametri, ca să afișeze în continuare „Cană” și „25 lei”.

Codul care dă eroarea
JSX
function Card(props) {
  return (
    <div className="card">
      <h3>{props.titlu}</h3>
      <p>{props.pret} lei</p>
    </div>
  );
}

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

Schimbă parametrul în { titlu, pret } și folosește direct titlu și pret.

Alte forme ale mesajului

  • Must use destructuring state assignment
  • Must use destructuring context assignment
  • Must use destructuring props assignment react/destructuring-assignment

Cum o eviți pe viitor

  • Destructurează props direct în parametri: function Card({ titlu, pret }).
  • Pune acolo și valorile implicite: { pret = 0 }.
  • La clase, destructurează la începutul lui render().
  • Activează ESLint în editor ca să vezi regula înainte de commit.

Întrebări frecvente

E o eroare sau doar stil?

Doar stil: React nu dă nicio eroare. Dar dacă proiectul are regula activă, build-ul sau pipeline-ul de CI pot pica din cauza ei, deci o repari.

Pot dezactiva regula?

Într-un proiect personal, da, în configurația ESLint. Într-o echipă, discută întâi: regula e acolo ca tot codul să arate la fel.

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.