Sandungan

Penggunaan flushSync tidak umum dan dapat menyebabkan penurunan kinerja aplikasi Anda.

flushSync dapat memaksa React untuk menge-flush pembaruan dalam callback yang diberikan secara sinkron. Ini memastikan bahwa DOM diperbarui dengan segera.

flushSync(callback)

Referensi

flushSync(callback)

Panggil flushSync untuk memaksa React menge-flush pekerjaan tertunda dan memperbarui DOM secara sinkon.

import { flushSync } from 'react-dom';

flushSync(() => {
setSomething(123);
});

Seringnya, flushSync dapat dihindari. Gunakan flushSync sebagai pilihan terakhir.

Lihat lebih banyak contoh di bawah.

Parameter

  • callback: Sebuah fungsi. React akan langsung memanggil callback ini dan menge-flush pembaruan di dalamnya secara sinkron. React juga dapat menge-flush pembaruan tertunda, atau Effects, atau pembaruan di dalam Effects. Jika sebuah pembaruan tertunda karena pemanggilan flushSync ini, fallback-nya dapat ditampilkan kembali.

Kembalian

flushSync mengembalikan undefined.

Catatan penting

  • flushSync dapat menurunkan performa secara signifikan. Jangan gunakan terlalu sering.
  • flushSync dapat memaksa batas Suspense tertunda untuk menampilkan state fallback-nya.
  • flushSync dapat menjakankan effects tertunda dan secara sinkron menerapkan pembaruan di dalamnya sebelum mengembalikan.
  • flushSync dapat menge-flush pembaruan di luar callback ketika perlu untuk menge-flush pembaruan di dalam callback. Misalnya, jika ada pembaruan tertunda dari sebuah klik, React dapat menge-flush pembaruan tersebut sebelum menge-flush pembaruan di dalam callback.

Penggunaan

Menge-flush pembaruan untuk integrasi pihak ketiga

Saat berintegrasi dengan kode pihak ketiga seperti API browser atau pustaka UI, mungkin akan diperlukan untuk memaksa React menge-flush pembaruan. Gunakan flushSync untuk memaksa react menge-flush pembaruan state di dalam callback secara sinkron:

flushSync(() => {
setSomething(123);
});
// Pada baris ini, DOM sudah diperbarui.

Ini memastikan bahwa, pada saat baris berikutnya berjalan, React sudah memperbarui DOM.

Penggunaan flushSync tidak umum, dan menggunakannya dengan sering dapat menurunkan performa aplikasi Anda secara signifikan. Jika aplikasi Anda hanya menggunakan API React, dan tidak berintegrasi dengan pustaka pihak ketiga, flushSync seharusnya tidak perlu digunakan.

Namun, flushSync dapat berguna untuk berintegrasi dengan kode pihak ketiga seperti API peramban.

Beberapa API peramban mengekspektasikan hasil di dalam callback ditulis ke DOM secara sinkron di akhir callback, sehingga peramban dapat melakukan sesuatu dengan DOM yang telah di-render. Dalam kebanyakan kasus, React menangani ini untuk Anda secara otomatis. Namun, dalam beberapa kasus, mungkin tidak diperlukan untuk memaksakan pembaruan sinkron.

Sebagai contoh, API peramban onbeforeprint memungkinkan Anda untuk mengubah halaman dengan segera sebelum dialog cetak (print dialog) terbuka. Ini berguna untuk menerapkan gaya cetak tersuai (custom print styles) yang memungkinkan dokumen untuk tampil lebih baik untuk dicetak. Dalam contoh di bawah, Anda menggunakan flushSync di dalam callback onbeforeprint untuk dengan segera “menge-flushstate React ke DOM. Kemudian, pada saat dialog cetak terbuka, isPrinting akan menampilkan “yes”:

import { useState, useEffect } from 'react';
import { flushSync } from 'react-dom';

export default function PrintApp() {
  const [isPrinting, setIsPrinting] = useState(false);

  useEffect(() => {
    function handleBeforePrint() {
      flushSync(() => {
        setIsPrinting(true);
      })
    }

    function handleAfterPrint() {
      setIsPrinting(false);
    }

    window.addEventListener('beforeprint', handleBeforePrint);
    window.addEventListener('afterprint', handleAfterPrint);
    return () => {
      window.removeEventListener('beforeprint', handleBeforePrint);
      window.removeEventListener('afterprint', handleAfterPrint);
    }
  }, []);

  return (
    <>
      <h1>isPrinting: {isPrinting ? 'yes' : 'no'}</h1>
      <button onClick={() => window.print()}>
        Print
      </button>
    </>
  );
}

Tanpa flushSync, dialog cetak akan menampilkan isPrinting sebagai “no”. Ini terjadi karena React mengelompokkan (batch) pembaruan secara asinkron dan dialog cetak ditampilkan sebelum state diperbarui.

Sandungan

flushSync dapat menurunkan performa secara signifikan, dan mungkin tiba-tiba memaksa batas Suspense yang tertunda untuk menampilkan state fallback-nya.

Seringnya, flushSync dapat dihindari, maka gunakan flushSync sebagai pilihan terakhir.