...
Eroare React · Componente clasă

Warning: Contor.shouldComponentUpdate(): Returned undefined instead of a boolean value. Make sure to return true or false.

Pe scurt

Metoda shouldComponentUpdate nu are return, deci întoarce undefined, pe care React îl tratează ca false: componenta nu se mai actualizează. Adaugă return în fața condiției (return stareNoua.n !== this.state.n) sau folosește React.PureComponent.

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

Ce înseamnă

shouldComponentUpdate(propsNoi, stareNoua) e o metodă de optimizare a componentelor clasă: React o apelează înainte de fiecare re-randare, iar dacă întoarce false, sare peste randare. Trebuie să întoarcă true sau false.

Greșeala tipică e o expresie scrisă fără return: stareNoua.n !== this.state.n; se calculează și se aruncă, funcția întoarce undefined, iar React îl tratează ca false. Rezultatul: starea se schimbă, dar ecranul rămâne înghețat. Avertismentul, cu numele componentei (Contor), apare la fiecare actualizare blocată.

Aceeași problemă apare cu acolade puse într-o funcție săgeată sau cu un if care întoarce doar pe o ramură. Dacă vrei doar să eviți randările când props și starea sunt la fel, nu scrie metoda deloc: React.PureComponent face comparația pentru tine, iar la componente funcție echivalentul e memo.

De ce apare: cauzele frecvente

1Expresie fără return

Greșit
JSX
shouldComponentUpdate(propsNoi, stareNoua) {
  stareNoua.n !== this.state.n;
}
Corect
JSX
shouldComponentUpdate(propsNoi, stareNoua) {
  return stareNoua.n !== this.state.n;
}

Fără return, rezultatul comparației se pierde, iar funcția întoarce undefined.

2return doar pe o ramură

Greșit
JSX
shouldComponentUpdate(propsNoi) {
  if (propsNoi.id !== this.props.id) {
    return true;
  }
}
Corect
JSX
shouldComponentUpdate(propsNoi) {
  return propsNoi.id !== this.props.id;
}

Pe ramura fără return, componenta nu se actualizează niciodată.

3Comparație scrisă de mână

Greșit
JSX
class Rand extends React.Component {
  shouldComponentUpdate(p) {
    p.nume !== this.props.nume;
  }
}
Corect
JSX
class Rand extends React.PureComponent {
  render() { ... }
}

PureComponent compară superficial props și starea, fără cod scris de tine.

Repară tu

Repară eroarea, direct în pagină

Contorul clasă de mai jos are o metodă shouldComponentUpdate fără return, iar React avertizează „Contor.shouldComponentUpdate(): Returned undefined instead of a boolean value”. Butonul rămâne la 0 oricât apeși. Repară metoda ca butonul #plus să afișeze 2 după două click-uri.

Codul care dă eroarea
JSX
import React from "react";

class Contor extends React.Component {
  state = { n: 0 };

  shouldComponentUpdate(propsNoi, stareNoua) {
    stareNoua.n !== this.state.n;
  }

  render() {
    return (
      <button id="plus" onClick={() => this.setState((s) => ({ n: s.n + 1 }))}>
        {this.state.n}
      </button>
    );
  }
}

export default function App() {
  return <Contor />;
}
Indiciu

Pune return în fața comparației stareNoua.n !== this.state.n.

Alte forme ale mesajului

  • Warning: Lista.shouldComponentUpdate(): Returned undefined instead of a boolean value. Make sure to return true or false.

Cum o eviți pe viitor

  • Scrie shouldComponentUpdate cu un singur return al unei expresii booleene.
  • Preferă React.PureComponent sau memo în loc de comparații scrise de mână.
  • Folosește metoda doar după ce ai măsurat o problemă de performanță.
  • Testează că un click care schimbă starea chiar actualizează ecranul.

Întrebări frecvente

De ce starea se schimbă, dar ecranul nu?

setState a schimbat starea, dar shouldComponentUpdate a întors undefined, adică „nu randa”. React a sărit peste randare, deci ecranul a rămas la valoarea veche.

Există așa ceva la componentele funcție?

Echivalentul e memo(Componenta, comparare). Atenție: funcția de comparare din memo întoarce true când props sunt egale, adică exact invers față de shouldComponentUpdate.

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.