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

Warning: componentWillReceiveProps has been renamed, and is not recommended for use. See https://reactjs.org/link/unsafe-component-lifecycles for details.

Pe scurt

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 în render);
  • poți redenumi metoda UNSAFE_componentWillReceiveProps ca 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

Greșit
JSX
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>;
  }
}
Corect
JSX
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

Greșit
JSX
componentWillReceiveProps(next) {
  if (next.id !== this.props.id) {
    this.incarca(next.id);
  }
}
Corect
JSX
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ă

Greșit
JSX
componentWillReceiveProps(next) {
  if (next.id !== this.props.id) this.incarca(next.id);
}
Corect
JSX
function Produs({ id }) {
  useEffect(() => {
    incarca(id);
  }, [id]);
  // ...
}

În componente funcție, useEffect cu [id] rulează exact când se schimbă id.

Repară tu

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.

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

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 cu useMemo în funcții).
  • Pune efectele declanșate de schimbarea props-urilor în componentDidUpdate(prevProps) sau în useEffect cu 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

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