Blog

Saya Membuat List React Native 8000x Lebih Cepat

20 Juni 2026 9 menit baca

Bagaimana PR saya yang sudah di-merge ke React Native membuat kerja render window FlatList dan VirtualizedList hingga 8000x lebih cepat.

Saya Membuat List React Native 8000x Lebih Cepat
React NativeFlatListVirtualizedListPerformaOpen Source

Ya, kamu tidak salah baca: 8000x lebih cepat.

Bukan dalam arti "seluruh aplikasimu sekarang 8000x lebih cepat, silakan beli kapal pesiar". Sayangnya.

Dan ya, saya tahu timing-nya lucu.

Kita hidup di era ketika berita AI bergerak begitu cepat sampai sesuatu seperti Claude Fable 5 bisa diluncurkan lalu ditangguhkan beberapa hari kemudian. Orang-orang berdebat soal model yang mendekati AGI, kontrol ekspor, agent yang mengerjakan proyek utuh, dan semacamnya.

Dan di sinilah saya, membahas cara membuat list React Native lebih cepat.

Kedengarannya agak aneh kalau dua hal itu diletakkan berdampingan. Saya paham.

Tapi saya tetap merasa pekerjaan seperti ini seru. Mungkin "penemuan" adalah kata yang terlalu besar, tetapi memperbaiki framework yang dipakai ribuan aplikasi tetap terasa bermakna bagi saya. Tidak semua hal yang berguna harus terlihat seperti fiksi ilmiah. Kadang itu hanya soal membuang pekerjaan sia-sia dari jalur yang disentuh hampir setiap aplikasi mobile.

Kemenangannya ada di satu jalur list React Native yang spesifik: kerja render window yang menentukan sel mana yang harus ada saat ini. Dalam benchmark itu, jalur lama bisa membuang waktu beberapa detik pada list yang sangat besar, dan jalur baru memangkasnya menjadi beberapa milidetik.

Sebagian besar waktu, kita berada di sisi aplikasi. Kita memakai FlatList, SectionList, navigasi, animasi, library state, dan semua hal yang biasa. Kita mengeluh soal performa, mencoba beberapa props, menambahkan memo, mungkin menambahkan getItemLayout, lalu melanjutkan hidup.

Tapi kadang masalah sebenarnya ada satu lapis di bawah kode aplikasi.

Itulah yang terjadi di sini.

Saya menyumbangkan peningkatan performa ke react/react-native, yang di-merge sebagai PR #57210. Perubahan ini menghapus pencarian sticky header yang tidak perlu dari jalur pembuatan render mask yang dipakai oleh VirtualizedList.

Timeline GitHub yang menunjukkan pull request performa FlatList sudah di-merge ke React Native
Sudah di-merge ke React Native. Masih terasa agak tidak nyata.

Dalam bahasa sehari-hari: React Native kadang memeriksa sticky header bahkan saat list tidak punya sticky header sama sekali.

Momen komputer klasik.

List: "Saya tidak punya sticky header."

React Native: "Oke, saya scan mundur dulu untuk mencarinya."

Bagian bagusnya, jalur ini dipakai bersama. Jadi peningkatannya berdampak pada:

  • VirtualizedList
  • FlatList
  • VirtualizedSectionList
  • SectionList

Dan ya, pemakaian FlatList biasa juga bisa ikut diuntungkan walaupun kamu sama sekali tidak memakai sticky header.

Apa yang sebenarnya diperbaiki

Sebelum masuk ke kode, ada baiknya menjelaskan jenis performa apa yang dibahas di sini.

Peningkatannya ada pada kerja JavaScript yang dilakukan React Native sebelum memutuskan baris mana yang harus dirender.

FlatList menyimpan sebuah render window. Saat kamu scroll, melompat, melakukan mount di dekat indeks awal, atau bergerak di dalam list yang besar, React Native perlu memutuskan sel mana yang harus dirender dan bagian mana yang cukup menjadi spacer.

Keputusan itu melewati VirtualizedList._createRenderMask.

Jadi kemenangannya adalah:

  • lebih sedikit kerja JS saat render window list diperbarui
  • lebih sedikit kerja saat melompat ke dekat ujung list yang sangat besar
  • lebih sedikit logika sticky header yang tidak perlu untuk list tanpa sticky header
  • keputusan yang lebih cepat sebelum list memperbarui apa yang harus tampil di layar

Dalam istilah aplikasi sehari-hari, ini membantu bagian FlatList yang memutuskan "baris mana yang harus ada saat ini?"

Untuk list yang sangat besar, terutama di dekat ujung list, keputusan internal kecil itu bisa menjadi biaya yang nyata.

Menghapus biaya itu membuat jalur pembaruan render window jauh lebih murah.

Hal yang saya perhatikan

FlatList adalah salah satu komponen yang hampir pasti dipakai setiap aplikasi React Native di suatu titik.

Dari luar terlihat sederhana:

<FlatList data={items} renderItem={renderItem} />

Tapi di baliknya, komponen ini berjalan lewat VirtualizedList.

VirtualizedList tidak merender seluruh sumber data. Kalau kamu punya 100k baris, ia tidak menaruh 100k baris di layar seperti prajurit yang berani tapi pasti kalah. Ia menyimpan render window dan memakai render mask untuk menentukan sel mana yang harus ada saat ini.

Itu bagus.

Masalahnya ada di dalam langkah pembuatan render mask.

React Native juga mendukung sticky header. Sticky header itu istimewa karena item sticky bisa berada di luar viewport normal, tetapi tetap harus dirender karena secara visual ia menempel di bagian atas.

Jadi React Native butuh logika seperti:

"Cari sticky header terdekat sebelum viewport dan tetap render."

Logika itu benar.

Bagian yang mengganggu adalah pencarian itu tetap bisa berjalan saat tidak ada sticky header.

Jalur lama

Sebelum perubahan ini, VirtualizedList._createRenderMask membuat sebuah set dari stickyHeaderIndices lalu memanggil helper sticky header.

Versi sederhananya seperti ini:

const stickyIndicesSet = new Set(props.stickyHeaderIndices);
VirtualizedList._ensureClosestStickyHeader(
  props,
  stickyIndicesSet,
  renderMask,
  cellsAroundViewport.first,
);

Lalu helper tersebut berjalan mundur dari sel pertama yang terlihat:

for (let itemIdx = cellIdx - 1; itemIdx >= 0; itemIdx--) {
  if (stickyIndicesSet.has(itemIdx + stickyOffset)) {
    renderMask.addCells({first: itemIdx, last: itemIdx});
    break;
  }
}

Untuk list kecil, ini tidak masalah.

Untuk list yang sangat besar, ini jadi menyakitkan. Kalau viewport berada di dekat ujung list berisi 1 juta baris, dan tidak ada sticky header, helper itu tetap bisa berjalan mundur melewati hampir seluruh list.

Pada dasarnya itu melakukan pencarian besar untuk menemukan ketiadaan.

Bukan hobi favorit saya.

Kenapa FlatList terdampak

Bagian ini mudah terlewat.

Kamu tidak perlu memakai VirtualizedList secara langsung. FlatList dibangun di atasnya.

Jadi kode seperti ini:

<FlatList
  data={bigData}
  renderItem={renderItem}
/>

tetap melewati VirtualizedList._createRenderMask.

Sebelum perubahan ini, list biasa tanpa stickyHeaderIndices tetap bisa menanggung biaya pencarian sticky header.

Setelah perubahan ini, React Native memeriksa apakah sticky header benar-benar ada sebelum mengerjakan logika sticky header.

Teknologi yang sangat canggih: cek dulu apakah sesuatu itu ada sebelum mencarinya.

Perubahannya

Bagian pertama adalah bagian yang penting untuk pemakaian FlatList biasa tanpa sticky.

const stickyHeaderIndices = props.stickyHeaderIndices;
if (stickyHeaderIndices != null && stickyHeaderIndices.length > 0) {
  VirtualizedList._ensureClosestStickyHeader(
    props,
    stickyHeaderIndices,
    renderMask,
    cellsAroundViewport.first,
  );
}

Kalau tidak ada sticky header, kita lewati helper-nya.

Bagian kedua juga memperbaiki kasus yang memakai sticky header.

Alih-alih berjalan mundur melalui indeks item, helper sekarang memindai indeks sticky header yang dikonfigurasi dan mencari sticky header valid terdekat sebelum viewport.

const stickyOffset = props.ListHeaderComponent ? 1 : 0;
const targetStickyIndex = cellIdx + stickyOffset;
let closestStickyIndex = null;

for (let itemIdx = 0; itemIdx < stickyHeaderIndices.length; itemIdx++) {
  const stickyIndex = stickyHeaderIndices[itemIdx];
  if (
    Number.isInteger(stickyIndex) &&
    stickyIndex < targetStickyIndex &&
    stickyIndex >= stickyOffset &&
    (closestStickyIndex == null || stickyIndex > closestStickyIndex)
  ) {
    closestStickyIndex = stickyIndex;
  }
}

if (closestStickyIndex != null) {
  const itemIdx = closestStickyIndex - stickyOffset;
  renderMask.addCells({first: itemIdx, last: itemIdx});
}

Jadi biayanya berubah dari:

"Seberapa jauh kita dari awal list?"

menjadi:

"Berapa banyak sticky header yang dikonfigurasi?"

Itu pertanyaan yang jauh lebih baik.

Menjaga perilaku tetap sama

Inilah bagian yang membuat perubahan kecil di framework tidak sekecil kelihatannya.

Kamu tidak bisa sekadar mengoptimasi lalu berharap semuanya baik-baik saja. stickyHeaderIndices bisa tidak terurut. Ia bisa berisi nilai duplikat. Ia bisa berisi nilai yang tidak valid. Bisa juga ada ListHeaderComponent, yang menggeser indeks sebanyak satu.

Semua itu tetap harus berfungsi.

Test-nya mencakup kasus seperti:

  • tanpa stickyHeaderIndices
  • stickyHeaderIndices kosong
  • indeks sticky yang tidak terurut
  • indeks sticky duplikat
  • nilai negatif
  • nilai pecahan
  • nilai setelah viewport
  • penanganan offset ListHeaderComponent

Yang terakhir itu penting. Indeks sticky header didasarkan pada indeks child ScrollView di bawahnya. Saat ada list header, indeks item 0 bukan lagi indeks child 0.

Bug off-by-one kecil suka sekali area ini. Mereka tinggal di sana tanpa bayar sewa.

Hasil benchmark

Saya melakukan benchmark langsung pada jalur VirtualizedList._createRenderMask dengan Fantom Hermes, memakai 100 sampel per kasus.

Benchmark ini berfokus pada kerja keputusan render window di dalam VirtualizedList.

Jadi tidak, ini tidak berarti setiap FlatList di setiap aplikasi tiba-tiba scroll 8000x lebih cepat. Andai saja. Saya pasti sudah jadi orang yang menyebalkan soal itu.

Artinya, jalur list windowing internal yang spesifik ini jadi jauh lebih murah. Dan saat benchmark berubah dari beberapa detik kerja sia-sia menjadi beberapa milidetik, itu tetap kemenangan yang sangat nyata.

Bukti di simulator

Saya juga membuat aplikasi React Native bare kecil untuk membandingkan kedua implementasi di iOS Simulator.

Aplikasi yang sama. FlatList yang sama dengan 1m baris. Setup no sticky headers yang sama.

Satu-satunya perbedaan adalah implementasi VirtualizedList yang terpasang. Ini adalah rekaman simulator sungguhan di dalam bingkai ponsel, bukan screenshot mockup statis. Saya sengaja membiarkan kontrol video terlihat, dan denyut kursor menandai saat tombol benchmark ditekan.

Benchmark dan test perilakunya juga ada di PR React Native yang sudah di-merge:

Sebelum
▶ video simulator
Sesudah
▶ video simulator

Di demo simulator, jalur lama tumbuh seiring ukuran list. Untuk 1k pembaruan render window, hasilnya seperti ini:

  • 50k rows: total sekitar 1.92 s (1.9196 ms / call)
  • 500k rows: total sekitar 18.78 s (18.78 ms / call)
  • 1m rows: total sekitar 38.40 s (38.40 ms / call)

Dengan jalur yang sudah dioptimasi, demo yang sama pada dasarnya tetap datar:

  • 50k rows: total sekitar 3.74 ms (0.0037 ms / call)
  • 500k rows: total sekitar 3.67 ms (0.0037 ms / call)
  • 1m rows: total sekitar 3.73 ms (0.0037 ms / call)

Nilai per panggilan berada di bawah 1 detik, jadi ditampilkan dalam milidetik. Untuk 1.000 pembaruan render mask, nilai di atas 1 detik ditampilkan dalam detik.

KasusSatu pembaruan sebelumSatu pembaruan sesudahPercepatan1.000 pembaruan sebelum1.000 pembaruan sesudah
100k baris, tanpa sticky header2.664 ms0.0034 ms780x2.66 s3.42 ms
100k baris, sticky header kosong2.632 ms0.0033 ms800x2.63 s3.29 ms
100k baris, satu sticky header di atas2.705 ms0.0054 ms499x2.71 s5.42 ms
250k baris, tanpa sticky header6.543 ms0.0035 ms1,892x6.54 s3.46 ms
250k baris, sticky header kosong6.579 ms0.0033 ms2,024x6.58 s3.25 ms
250k baris, satu sticky header di atas6.796 ms0.0053 ms1,294x6.80 s5.25 ms
500k baris, tanpa sticky header13.173 ms0.0033 ms4,002x13.17 s3.29 ms
500k baris, sticky header kosong13.073 ms0.0033 ms3,997x13.07 s3.27 ms
500k baris, satu sticky header di atas13.444 ms0.0054 ms2,511x13.44 s5.35 ms
750k baris, tanpa sticky header19.524 ms0.0033 ms6,008x19.52 s3.25 ms
750k baris, sticky header kosong19.572 ms0.0033 ms6,022x19.57 s3.25 ms
750k baris, satu sticky header di atas20.304 ms0.0054 ms3,778x20.30 s5.37 ms
1m baris, tanpa sticky header26.190 ms0.0033 ms8,058x26.19 s3.25 ms
1m baris, sticky header kosong26.039 ms0.0033 ms8,012x26.04 s3.25 ms
1m baris, satu sticky header di atas26.855 ms0.0053 ms5,075x26.86 s5.29 ms

Kolom 1.000 pembaruan membuat perbedaannya lebih terasa.

Pada 1 juta baris, jalur lama tanpa sticky menghabiskan sekitar 26 detik di helper ini untuk 1.000 pembaruan render mask.

Setelah perubahan, kasus yang sama hanya sekitar 3.25 ms.

Itulah waktu yang dihapus dari jalur list bersama sebelum React Native memutuskan sel mana yang harus dirender.

Rencana pengujian

Saya ingin perubahan ini membosankan dalam arti terbaik: perilaku sama, kerja lebih sedikit.

Jadi kontribusi ini menyertakan test perilaku dan cakupan benchmark.

Perintah utamanya adalah:

yarn jest packages/virtualized-lists/Lists/__tests__/VirtualizedList-test.js packages/virtualized-lists/Lists/__tests__/VirtualizedSectionList-test.js packages/react-native/Libraries/Lists/__tests__/FlatList-test.js --runInBand
yarn fantom packages/react-native/Libraries/Lists/__tests__/FlatList-itest.js packages/react-native/Libraries/Lists/__tests__/SectionList-itest.js --runInBand
yarn flow check
yarn fantom --benchmarks packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js --runInBand

PR ini mengubah tiga file:

  • implementasi VirtualizedList
  • test VirtualizedList yang terfokus
  • benchmark Fantom untuk jalur render mask sticky header

PR ini diimpor melalui proses Meta dan di-merge ke react/react-native.

Penutup

Yang saya suka dari kontribusi ini adalah developer aplikasi tidak perlu melakukan apa pun.

Tidak ada prop baru.

Tidak ada migrasi.

Tidak ada workaround.

Kalau sebuah aplikasi memakai FlatList besar tanpa sticky header, React Native sekarang bisa menghindari pencarian sticky header yang sejak awal memang tidak perlu.

Itulah jenis peningkatan framework favorit saya.

Permukaan perubahan kecil. Benchmark jelas. Tanpa perubahan API.

Dan jalur yang umum jadi lebih murah untuk semua orang.