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.
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
useEffect(() => {
flushSync(() => setMesaj("Gata"));
}, []);useEffect(() => {
setMesaj("Gata");
}, []);Un setState în efect programează oricum o randare nouă; flushSync nu aduce nimic aici.
2flushSync în componentDidMount
componentDidMount() {
flushSync(() => this.setState({ gata: true }));
}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
useEffect(() => {
flushSync(() => setProduse(lista));
refFinal.current.scrollIntoView();
}, [lista]);function adauga() {
flushSync(() => setProduse([...produse, nou]));
refFinal.current.scrollIntoView();
}Locul potrivit pentru flushSync e un handler de eveniment, nu un efect.
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!”.
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.
Reparația
import { useEffect, useState } from "react";
export default function App() {
const [mesaj, setMesaj] = useState("Se pregătește...");
useEffect(() => {
setMesaj("Bun venit în magazin!");
}, []);
return <p id="mesaj">{mesaj}</p>;
}De ce merge
Efectul rula în timp ce React termina randarea, așa că flushSync nu putea forța o actualizare sincronă: React o amâna și avertiza.
Un setMesaj simplu în efect programează o randare nouă imediat după cea curentă. Rezultatul pe ecran e același, fără avertisment și fără importul din react-dom.
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
flushSyncdoar î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
setStatesimplu. - 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
Warning: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render. Un useEffect setează state la fiecare randare, iar fiecare setare pornește o randare nouă: efectul n-are listă de dependențe sau depinde de ceva recreat la fiecare randare. Pune dependențele corecte sau calculează valoarea fără efect. Warning: Cannot update during an existing state transition (such as within `render`). Render methods should be a pure function of props and state. O componentă clasă apelează this.setState în timpul randării: direct în render() sau printr-un handler apelat în JSX (onClick={this.sterge(id)}). Pasează funcția, nu rezultatul ei (onClick={() => this.sterge(id)}), și calculează valorile derivate fără setState. React Hook useEffect contains a call to 'setVizite'. Without a list of dependencies, this can lead to an infinite chain of updates. To fix this, pass [] as a second argument to the useEffect Hook. Un useEffect fără al doilea argument rulează după fiecare randare, iar setState din el produce o randare nouă, deci o buclă infinită. Dacă efectul trebuie să ruleze o dată, la montare, adaugă []; dacă depinde de anumite valori, pune-le în listă: [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.
