Do not mutate state directly. Use setState().
Într-o componentă clasă ai scris this.state.n = ... în afara constructorului. React nu află de schimbare, deci nu re-randează, iar valoarea poate fi suprascrisă la următorul setState. Folosește this.setState((stare) => ({ n: stare.n + 1 })).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Regula ESLint react/no-direct-mutation-state raportează orice atribuire la this.state (sau la o proprietate a lui) în afara constructorului. În clasă, singurul mod prin care React află că starea s-a schimbat este this.setState(): el programează o re-randare și combină noua stare cu cea veche.
Când scrii this.state.n = this.state.n + 1, valoarea se schimbă în memorie, dar React nu știe. Ecranul rămâne la valoarea veche până când altceva provoacă o randare, iar atunci apare brusc valoarea „ascunsă”. Mai mult, un setState ulterior poate porni de la o copie veche și îți pierde modificarea.
Excepția e constructorul: acolo this.state = { ... } este chiar felul corect de a inițializa starea. La fel și câmpul de clasă state = { ... }. Aceeași idee la componentele funcție: nu modifica obiectul din useState, ci dă setter-ului unul nou.
De ce apare: cauzele frecvente
1Atribuire directă într-un handler
creste = () => {
this.state.n = this.state.n + 1;
};creste = () => {
this.setState((stare) => ({ n: stare.n + 1 }));
};setState anunță React, care re-randează componenta cu noua valoare.
2push pe un tablou din stare
adauga = (p) => {
this.state.produse.push(p);
this.setState({ produse: this.state.produse });
};adauga = (p) => {
this.setState((stare) => ({ produse: [...stare.produse, p] }));
};Creezi un tablou nou, deci starea veche rămâne neschimbată, iar comparațiile din PureComponent și memo funcționează.
3Modificare de obiect imbricat
this.state.user.nume = "Ana";
this.forceUpdate();this.setState((stare) => ({ user: { ...stare.user, nume: "Ana" } }));forceUpdate ascunde problema; o copie cu spread păstrează starea imuabilă.
Repară eroarea, direct în pagină
Contorul clasă de mai jos crește this.state.n direct, iar ESLint raportează „Do not mutate state directly. Use setState()”. La click, numărul de pe buton nu se schimbă. Repară metoda creste ca butonul #plus să afișeze 2 după două click-uri.
import React from "react";
class Contor extends React.Component {
state = { n: 0 };
creste = () => {
this.state.n = this.state.n + 1;
};
render() {
return <button id="plus" onClick={this.creste}>{this.state.n}</button>;
}
}
export default function App() {
return <Contor />;
}Indiciu
Înlocuiește atribuirea cu this.setState((stare) => ({ n: stare.n + 1 })).
Reparația
import React from "react";
class Contor extends React.Component {
state = { n: 0 };
creste = () => {
this.setState((stare) => ({ n: stare.n + 1 }));
};
render() {
return <button id="plus" onClick={this.creste}>{this.state.n}</button>;
}
}
export default function App() {
return <Contor />;
}De ce merge
this.state.n = ... schimba valoarea fără să-i spună lui React, așa că butonul nu era re-randat și afișa în continuare 0.
this.setState((stare) => ({ n: stare.n + 1 })) calculează noua stare din cea curentă și programează o re-randare. După fiecare click, React afișează valoarea nouă: 1, apoi 2.
Alte forme ale mesajului
Do not mutate state directly. Use setState(). react/no-direct-mutation-state
Cum o eviți pe viitor
- În clase, schimbă starea doar cu
this.setState;this.state = ...doar în constructor. - Pentru tablouri și obiecte, creează copii (
[...lista, x],{ ...obj, camp: v }), nu folosipushsau atribuiri. - Folosește forma cu funcție când noua stare depinde de cea veche.
- Păstrează regula
react/no-direct-mutation-stateactivă.
Întrebări frecvente
De ce valoarea apare abia după alt click?
Pentru că modificarea directă a schimbat valoarea în memorie, dar n-a cerut re-randare. Următorul setState (din altă parte) randează componenta, iar atunci se vede și modificarea ascunsă.
E aceeași greșeală ca la useState?
Da, aceeași idee: la useState nu modifici obiectul sau tabloul din stare, ci dai setter-ului unul nou. La clase, în plus, nu ai voie să atribui this.state în afara constructorului.
Erori înrudite
Use callback in setState when referencing the previous state. Ai scris this.setState({ n: this.state.n + 1 }). setState e asincron și grupat, deci this.state poate fi încă valoarea veche: două apeluri la rând cresc doar cu 1. Folosește forma cu funcție: this.setState((stare) => ({ n: stare.n + 1 })). TypeError: Cannot assign to read only property 'titlu' of object '#<Object>' Componenta încearcă să modifice un prop (props.titlu = ...). În React props-urile sunt doar pentru citire; calculează valoarea nouă într-o variabilă locală sau cere părintelui s-o schimbe. TypeError: Cannot read properties of undefined (reading 'setState') Într-o componentă clasă, metoda folosită ca handler își pierde this, deci this.setState nu există. Scrie metoda ca arrow function (plus = () => {...}) sau leag-o în constructor cu bind. Î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.
