...
Eroare React · useEffect și încărcarea datelor

Warning: flushSync was called from inside a lifecycle method. React cannot flush when React is already rendering. Consider moving this call to a scheduler task or micro task.

Pe scurt

Ai apelat flushSync într-un useEffect, useLayoutEffect sau într-o metodă de ciclu de viață, adică exact când React lucrează la o randare. React nu poate forța atunci o randare sincronă. Scoate flushSync (setState simplu e suficient în efect) sau mută apelul într-un handler de eveniment.

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

Ce înseamnă

flushSync(fn) din react-dom îi cere lui React să aplice imediat, sincron, actualizările de stare din fn, ca DOM-ul să fie la zi pe linia următoare. E util rar, de exemplu într-un handler de click, când trebuie să derulezi la un element abia adăugat.

Mesajul spune că ai apelat flushSync în timp ce React era deja ocupat cu o randare: în useEffect, useLayoutEffect, componentDidMount sau componentDidUpdate. React nu poate întrerupe ce face ca să golească altă coadă de actualizări, așa că ignoră caracterul „sincron”, aplică actualizarea mai târziu și te avertizează.

De cele mai multe ori flushSync nici nu e necesar acolo: un setState simplu într-un efect produce oricum o randare nouă. Dacă ai nevoie de DOM-ul actualizat, citește-l în efectul următor sau în useLayoutEffect. Sugestia din mesaj („scheduler task sau micro task”) înseamnă să muți apelul în afara randării, de exemplu cu queueMicrotask.

De ce apare: cauzele frecvente

1flushSync într-un useEffect

Greșit
JSX
useEffect(() => {
  flushSync(() => setMesaj("Gata"));
}, []);
Corect
JSX
useEffect(() => {
  setMesaj("Gata");
}, []);

Un setState în efect programează oricum o randare nouă; flushSync nu aduce nimic aici.

2flushSync în componentDidMount

Greșit
JSX
componentDidMount() {
  flushSync(() => this.setState({ gata: true }));
}
Corect
JSX
componentDidMount() {
  this.setState({ gata: true });
}

În metodele de ciclu de viață, React e în mijlocul unei randări și nu poate face încă una sincron.

3Vrei DOM-ul actualizat după click

Greșit
JSX
useEffect(() => {
  flushSync(() => setProduse(lista));
  refFinal.current.scrollIntoView();
}, [lista]);
Corect
JSX
function adauga() {
  flushSync(() => setProduse([...produse, nou]));
  refFinal.current.scrollIntoView();
}

Locul potrivit pentru flushSync e un handler de eveniment, nu un efect.

Repară tu

Repară eroarea, direct în pagină

Efectul de mai jos schimbă mesajul cu flushSync, iar React avertizează „flushSync was called from inside a lifecycle method. React cannot flush when React is already rendering”. Repară efectul (fără flushSync), ca #mesaj să afișeze „Bun venit în magazin!”.

Codul care dă eroarea
JSX
import { useEffect, useState } from "react";
import { flushSync } from "react-dom";

export default function App() {
  const [mesaj, setMesaj] = useState("Se pregătește...");

  useEffect(() => {
    flushSync(() => setMesaj("Bun venit în magazin!"));
  }, []);

  return <p id="mesaj">{mesaj}</p>;
}
Indiciu

În efect, un setMesaj(...) simplu e suficient.

Alte forme ale mesajului

  • Warning: flushSync was called from inside a lifecycle method. React cannot flush when React is already rendering. Consider moving this call to a scheduler task or micro task. at App

Cum o eviți pe viitor

  • Folosește flushSync doar în handlere de evenimente, și doar când ai nevoie de DOM-ul la zi imediat.
  • În efecte și metode de ciclu de viață, folosește setState simplu.
  • Pentru măsurători de DOM după o actualizare, folosește useLayoutEffect.
  • Caută flushSync în bibliotecile pe care le folosești dacă avertismentul apare fără să-l fi scris tu.

Întrebări frecvente

Avertismentul vine dintr-o bibliotecă, nu din codul meu. Ce fac?

Unele biblioteci (editoare, tabele, animații) apelează flushSync intern. Verifică dacă le apelezi metodele dintr-un efect; mută apelul într-un handler sau actualizează biblioteca la o versiune nouă.

Aplicația merge. E grav?

Nu strică nimic: React aplică actualizarea puțin mai târziu. Dar dacă te bazai pe DOM-ul actualizat imediat după flushSync, codul acela citește încă valori vechi.

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.