Warning: componentWillReceiveProps has been renamed, and is not recommended for use. See https://reactjs.org/link/unsafe-component-lifecycles for details.
O componentă clasă folosește componentWillReceiveProps, o metodă veche pe care React o marchează ca nesigură. Dacă doar calculezi ceva din props, calculează direct în render; pentru efecte după o schimbare de props folosește componentDidUpdate(prevProps); ca ultimă variantă, redenumește-o UNSAFE_componentWillReceiveProps.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
componentWillReceiveProps(nextProps) era apelată înainte ca o componentă clasă să primească props noi și se folosea pentru a copia props în state sau pentru a porni cereri. Din React 16.3 este considerată nesigură: cu randarea concurentă, poate fi apelată de mai multe ori pentru aceeași actualizare, iar copierea props în state duce ușor la date desincronizate.
Avertismentul îți spune trei lucruri, în lista de sub el:
- efectele (cereri, abonări) se mută în
componentDidUpdate; - dacă doar actualizezi state-ul din props, folosește memoizare sau
static getDerivedStateFromProps(de cele mai multe ori nici nu ai nevoie de state: calculezi din props înrender); - poți redenumi metoda
UNSAFE_componentWillReceivePropsca să scapi de avertisment fără să schimbi logica, dar asta doar amână problema.
La final, mesajul spune ce componente au metoda (Please update the following components: Pret). Același tip de avertisment există pentru componentWillMount și componentWillUpdate. Dacă vine dintr-o bibliotecă din node_modules, actualizeaz-o.
De ce apare: cauzele frecvente
1Props copiate în state
class Pret extends React.Component {
state = { cuTva: this.props.pret * 1.19 };
componentWillReceiveProps(next) {
this.setState({ cuTva: next.pret * 1.19 });
}
render() {
return <p>{this.state.cuTva} lei</p>;
}
}class Pret extends React.Component {
render() {
const cuTva = this.props.pret * 1.19;
return <p>{cuTva} lei</p>;
}
}O valoare care se poate calcula din props nu are nevoie de state: calculul din render e mereu sincronizat.
2Cerere pornită la schimbarea unui prop
componentWillReceiveProps(next) {
if (next.id !== this.props.id) {
this.incarca(next.id);
}
}componentDidUpdate(prevProps) {
if (prevProps.id !== this.props.id) {
this.incarca(this.props.id);
}
}componentDidUpdate rulează o singură dată, după ce actualizarea a ajuns în DOM, deci e locul sigur pentru efecte.
3Componentă funcție echivalentă
componentWillReceiveProps(next) {
if (next.id !== this.props.id) this.incarca(next.id);
}function Produs({ id }) {
useEffect(() => {
incarca(id);
}, [id]);
// ...
}În componente funcție, useEffect cu [id] rulează exact când se schimbă id.
Repară eroarea, direct în pagină
Componenta clasă PretCuTva de mai jos dă avertismentul „componentWillReceiveProps has been renamed, and is not recommended for use”. Repar-o fără componentWillReceiveProps și fără state copiat din props, ca #pret să afișeze „119 lei” la început și „238 lei” după click pe #dublu.
import { useState } from "react";
class PretCuTva extends React.Component {
constructor(props) {
super(props);
this.state = { cuTva: Math.round(props.pret * 1.19) };
}
componentWillReceiveProps(next) {
this.setState({ cuTva: Math.round(next.pret * 1.19) });
}
render() {
return <p id="pret">{this.state.cuTva} lei</p>;
}
}
export default function App() {
const [pret, setPret] = useState(100);
return (
<div>
<PretCuTva pret={pret} />
<button id="dublu" onClick={() => setPret(pret * 2)}>Dublează</button>
</div>
);
}Indiciu
Calculează prețul cu TVA direct în render, din this.props.
Reparația
import { useState } from "react";
class PretCuTva extends React.Component {
render() {
const cuTva = Math.round(this.props.pret * 1.19);
return <p id="pret">{cuTva} lei</p>;
}
}
export default function App() {
const [pret, setPret] = useState(100);
return (
<div>
<PretCuTva pret={pret} />
<button id="dublu" onClick={() => setPret(pret * 2)}>Dublează</button>
</div>
);
}De ce merge
componentWillReceiveProps copia prețul primit în state, ca să-l țină sincronizat. Metoda este învechită, poate fi apelată de mai multe ori pentru aceeași actualizare și te obligă să ții două copii ale aceleiași informații.
Prețul cu TVA depinde doar de this.props.pret, așa că se calculează direct în render. La fiecare props nou, React apelează render din nou, iar valoarea afișată e mereu cea corectă, fără state și fără metode speciale.
Alte forme ale mesajului
Warning: componentWillMount has been renamed, and is not recommended for use. See https://reactjs.org/link/unsafe-component-lifecycles for details.Warning: componentWillUpdate has been renamed, and is not recommended for use. See https://reactjs.org/link/unsafe-component-lifecycles for details.Warning: Using UNSAFE_componentWillReceiveProps in strict mode is not recommended and may indicate bugs in your code.Warning: Unsafe legacy lifecycles will not be called for components using new component APIs.
Cum o eviți pe viitor
- Nu copia props în state: calculează valorile derivate în
render(sau cuuseMemoîn funcții). - Pune efectele declanșate de schimbarea props-urilor în
componentDidUpdate(prevProps)sau înuseEffectcu dependențe. - Când state-ul trebuie resetat la schimbarea unui id, dă componentei
key={id}: React o montează din nou. - Scrie componentele noi ca funcții; metodele „componentWill...” nu mai au echivalent acolo.
Întrebări frecvente
Dacă redenumesc metoda în UNSAFE_componentWillReceiveProps, e rezolvat?
Avertismentul dispare, dar comportamentul rămâne același și poate da bug-uri în modul concurent sau în StrictMode. E o soluție temporară pentru cod vechi, nu una de folosit în cod nou.
Avertismentul vine dintr-o bibliotecă. Ce pot face?
Actualizează biblioteca: majoritatea au scăpat de aceste metode. Dacă nu mai e întreținută, caută o alternativă; până atunci, avertismentul e doar informativ.
Erori înrudite
Warning: Produs(...): No `render` method found on the returned component instance: you may have forgotten to define `render`. O componentă clasă (class Produs extends React.Component) nu are metoda render, de obicei pentru că ai scris-o greșit (Render, randeaza, rendr) sau ai pus-o în afara clasei. Adaugă render() { return (...); } în clasă sau transformă componenta într-o funcție. 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. React Hook useEffect has a missing dependency: 'id'. Either include it or remove the dependency array. Efectul folosește o valoare (prop sau state) care lipsește din lista de dependențe, deci nu rulează din nou când ea se schimbă. Adaug-o în listă: useEffect(() => {...}, [id]). Î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.
