Must use destructuring props assignment
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
function Card(props) {
return <h3>{props.titlu}</h3>;
}function Card({ titlu }) {
return <h3>{titlu}</h3>;
}Destructurarea în parametri arată din prima linie ce primește componenta.
2this.props în clasă
render() {
return <h3>{this.props.titlu}</h3>;
}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
function Buton(props) {
return <button className="btn" {...props}>{props.eticheta}</button>;
}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ă 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”.
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.
Reparația
function Card({ titlu, pret }) {
return (
<div className="card">
<h3>{titlu}</h3>
<p>{pret} lei</p>
</div>
);
}
export default function App() {
return <Card titlu="Cană" pret={25} />;
}De ce merge
Regula react/destructuring-assignment cere ca props să fie scoase o singură dată, prin destructurare. props.titlu și props.pret mergeau, dar încălcau stilul impus de ESLint.
Cu function Card({ titlu, pret }), ce primește componenta se vede din semnătură, iar în JSX folosești direct titlu și pret. Afișarea rămâne aceeași.
Alte forme ale mesajului
Must use destructuring state assignmentMust use destructuring context assignmentMust 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
'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. 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ă. Do not pass children as props. Instead, nest children between the opening and closing tags. Regula ESLint react/no-children-prop îți spune că ai scris children ca atribut: <Panou children={<p>...</p>} />. Merge, dar nu e forma obișnuită. Pune conținutul între tagul de deschidere și cel de închidere: <Panou><p>...</p></Panou>. Î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.
