# Я зробив списки в React Native у 8000 разів швидшими

By Tarik Pinarci (https://tarikpinarci.com). Published 2026-06-20. Canonical: https://tarikpinarci.com/uk/blog/improving-flatlist-performance-in-react-native

Так, ви правильно прочитали: у 8000 разів швидше.

Не в стилі «увесь ваш застосунок тепер у 8000 разів швидший, ідіть купуйте яхту». На жаль.

І так, я знаю, що час для цього кумедний.

Ми живемо в епоху, коли новини про AI рухаються так швидко, що [Claude Fable 5 може вийти, а за кілька днів його призупинять](https://www.anthropic.com/news/claude-fable-5-mythos-5). Люди сперечаються про моделі майже рівня AGI, експортний контроль, агентів, які роблять цілі проєкти, і все таке.

А я тут розповідаю, як зробити списки в React Native швидшими.

Якщо поставити ці дві речі поруч, звучить трохи дивно. Я розумію.

Але мене така робота досі захоплює. Можливо, «винахід» це завелике слово, але покращувати фреймворк, яким користуються тисячі застосунків, для мене все одно має сенс. Не все корисне мусить виглядати як наукова фантастика. Іноді це просто прибрати зайву роботу зі шляху, через який проходить майже кожен мобільний застосунок.

Виграш стосується одного конкретного шляху списків у React Native: роботи з render-вікном, яка вирішує, які комірки мають існувати саме зараз. У цьому бенчмарку старий шлях міг марнувати секунди на величезних списках, а новий скорочує це до кількох мілісекунд.

Здебільшого ми працюємо на боці застосунку. Використовуємо `FlatList`, `SectionList`, навігацію, анімації, бібліотеки стану і все звичне. Скаржимося на продуктивність, пробуємо якісь пропси, додаємо `memo`, можливо `getItemLayout`, і живемо далі.

Але іноді справжня проблема лежить на рівень нижче коду застосунку.

Саме так сталося тут.

Я зробив внесок у `react/react-native` з покращенням продуктивності, його змерджили як [PR #57210](https://github.com/react/react-native/pull/57210). Ця зміна прибирає непотрібний пошук sticky headers зі шляху створення render mask, яким користується `VirtualizedList`.

<figure style="max-width:720px; margin:24px auto 30px;">
  <img
    src="/images/blog/react-native-merged-proof/flatlist-merged.jpg"
    alt="Таймлайн GitHub, де pull request з покращенням продуктивності FlatList змерджено в React Native"
    style="width:100%; border-radius:14px; border:1px solid rgba(255,255,255,0.12);"
  />
  <figcaption style="margin-top:8px; text-align:center; font-size:0.9rem; color:#9ca3af;">Змерджено в React Native. Досі здається трохи нереальним.</figcaption>
</figure>

Простими словами: React Native іноді шукав sticky headers навіть тоді, коли в списку їх не було взагалі.

Класичний момент з компʼютерами.

> Список: «У мене немає sticky headers.»
>
> React Native: «Чудово, зараз пошукаю один, пройшовшись назад.»

Приємно те, що цей шлях спільний. Тож покращення стосується:

- `VirtualizedList`
- `FlatList`
- `VirtualizedSectionList`
- `SectionList`

І так, звичайний `FlatList` теж отримує користь, навіть якщо ви взагалі не використовуєте sticky headers.

### Що саме це покращує

Перш ніж переходити до коду, варто сказати, про яку саме продуктивність ідеться.

Покращення стосується роботи JavaScript, яку React Native виконує, перш ніж вирішити, які рядки рендерити.

`FlatList` тримає render-вікно. Коли ви скролите, перестрибуєте, монтуєте список біля початкового індексу або рухаєтеся великим списком, React Native має вирішити, які комірки рендерити, а які частини можна залишити як порожні проміжки.

Це рішення проходить через `VirtualizedList._createRenderMask`.

Тож виграш такий:

- менше роботи JS під час оновлення вікна списку
- менше роботи під час стрибка ближче до кінця величезного списку
- менше зайвої логіки sticky headers для списків без sticky headers
- швидші рішення, перш ніж список оновить те, що має бути на екрані

Мовою звичайного застосунку, це допомагає тій частині `FlatList`, яка вирішує: «які рядки мають існувати саме зараз?»

Для дуже великих списків, особливо ближче до кінця, це маленьке внутрішнє рішення може стати реальною вартістю.

Якщо цю вартість прибрати, шлях оновлення render-вікна стає набагато дешевшим.

### Що я помітив

`FlatList` належить до тих компонентів, якими рано чи пізно користується майже кожен застосунок на React Native.

Ззовні він виглядає просто:

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

Але під капотом він проходить через `VirtualizedList`.

`VirtualizedList` не рендерить усе джерело даних. Якщо у вас 100k рядків, він не виводить на екран 100k рядків, як хоробрий, але приречений солдат. Він тримає render-вікно і використовує render mask, щоб вирішити, які комірки мають існувати саме зараз.

І це добре.

Проблема була всередині кроку створення render mask.

React Native також підтримує sticky headers. Вони особливі, бо sticky елемент може бути поза звичайною видимою областю, але його все одно треба рендерити, бо візуально він закріплений угорі.

Тому React Native потрібна логіка на кшталт:

«Знайди найближчий sticky header перед видимою областю і залиш його відрендереним.»

Ця логіка правильна.

Прикро було те, що пошук міг запускатися навіть тоді, коли sticky headers не було.

### Старий шлях

До цієї зміни `VirtualizedList._createRenderMask` будував множину з `stickyHeaderIndices` і викликав допоміжну функцію для sticky headers.

Спрощено це виглядало так:

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

Потім допоміжна функція йшла назад від першої видимої комірки:

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

Для маленького списку це байдуже.

Для дуже великого списку це стає болем. Якщо видима область біля кінця списку з 1 мільйона рядків, а sticky headers немає, допоміжна функція все одно може пройти назад майже через увесь список.

По суті, це великий пошук, щоб нічого не знайти.

Не моє улюблене хобі.

![](https://media.giphy.com/media/FASybzL1ElrxpT2rTq/giphy.gif)

### Чому це стосується FlatList

Цю частину легко пропустити.

Вам не треба використовувати `VirtualizedList` напряму. `FlatList` побудований поверх нього.

Тож такий код:

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

все одно проходить через `VirtualizedList._createRenderMask`.

До зміни звичайний список без `stickyHeaderIndices` усе одно міг платити за пошук sticky headers.

Після зміни React Native спершу перевіряє, чи sticky headers взагалі існують, і лише тоді виконує з ними роботу.

Дуже передова технологія: перевірити, чи річ існує, перш ніж її шукати.

### Зміна

Перша частина найважливіша для звичайного `FlatList` без sticky.

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

Якщо sticky headers немає, ми пропускаємо допоміжну функцію.

Друга частина покращує і випадок зі sticky headers.

Замість того щоб іти назад по індексах елементів, допоміжна функція перебирає задані індекси sticky headers і знаходить найближчий коректний sticky header перед видимою областю.

```js
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});
}
```

Тож вартість змінюється з:

«Як далеко ми від початку списку?»

на:

«Скільки sticky headers задано?»

Це набагато краще питання.

### Поведінка лишається тією самою

Саме через це маленькі зміни у фреймворку менш маленькі, ніж здаються.

Не можна просто оптимізувати і сподіватися, що все буде гаразд. `stickyHeaderIndices` можуть бути невідсортованими. Вони можуть містити дублікати. Можуть містити некоректні значення. Може бути `ListHeaderComponent`, який зсуває індекс на одиницю.

Усе це має працювати й далі.

Тести покривають такі випадки:

- без `stickyHeaderIndices`
- порожній `stickyHeaderIndices`
- невідсортовані sticky індекси
- дублікати sticky індексів
- відʼємні значення
- дробові значення
- значення після видимої області
- обробка зсуву через `ListHeaderComponent`

Останній пункт важливий. Індекси sticky headers базуються на індексах дочірніх елементів `ScrollView`. Коли є заголовок списку, елемент з індексом `0` уже не дочірній елемент з індексом `0`.

Маленькі помилки на одиницю обожнюють це місце. Живуть там безкоштовно.

### Результати бенчмарку

Я заміряв шлях `VirtualizedList._createRenderMask` напряму у Fantom Hermes, по 100 вимірів на кожен випадок.

Цей бенчмарк зосереджений на рішеннях щодо render-вікна всередині `VirtualizedList`.

Тож ні, це не означає, що кожен `FlatList` у кожному застосунку раптом скролиться у 8000 разів швидше. Хотілося б. Я б уже був нестерпним з цього приводу.

Це означає, що цей конкретний внутрішній шлях віконного рендерингу списків став набагато дешевшим. А коли бенчмарк переходить від секунд змарнованої роботи до кількох мілісекунд, це все одно цілком реальний виграш.

### Доказ на симуляторі

Я також зробив невеликий bare застосунок на React Native, щоб порівняти обидві реалізації в iOS Simulator.

Той самий застосунок. Той самий `FlatList` на `1m` рядків. Те саме налаштування `no sticky headers`.

Єдина відмінність у встановленій реалізації `VirtualizedList`. Це справжні записи з симулятора всередині рамок телефона, а не статичні скриншоти макетів. Я навмисно залишив видимими елементи керування відео, а пульсація курсора позначає натискання кнопки бенчмарку.

Бенчмарк і тести поведінки також є в змердженому PR у React Native:

- [Бенчмарк-тест Fantom](https://github.com/react/react-native/blob/6b3a15b2c0eca3647e4648d4b68bcccd4336d42f/packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js)
- [Тести поведінки VirtualizedList](https://github.com/react/react-native/blob/6b3a15b2c0eca3647e4648d4b68bcccd4336d42f/packages/virtualized-lists/Lists/__tests__/VirtualizedList-test.js)
- [Змерджений PR #57210](https://github.com/react/react-native/pull/57210)

<div style="display:grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 36px; margin: 32px 0 42px; align-items:start; perspective:1400px;">
  <figure style="margin:0; transform:rotateY(10deg) rotateX(3deg); transform-style:preserve-3d;">
    <figcaption style="font-weight:700; color:#fca5a5; margin-bottom:14px; text-align:center;">До</figcaption>
    <div style="position:relative; max-width:330px; margin:0 auto; aspect-ratio:985/2008; filter:drop-shadow(32px 34px 46px rgba(0,0,0,0.58));">
    <div style="position:absolute; z-index:3; left:10%; top:5.5%; padding:5px 9px; border-radius:999px; background:rgba(0,0,0,0.68); border:1px solid rgba(255,255,255,0.16); color:#f8fafc; font-size:0.72rem; font-weight:700; pointer-events:none;">▶ відео з симулятора</div>
    <video
      data-autoplay="viewport"
      autoplay
      controls
      playsinline
      muted
      loop
      preload="metadata"
      style="position:absolute; left:5.19%; top:2.17%; width:89.93%; height:95.66%; border-radius:8.8%/4.1%; object-fit:cover; background:#05080f;"
      src="/videos/blog/flatlist-performance/before-release-simplified.mp4"
    >
      Ваш браузер не підтримує тег video.
    </video>
    <div class="flatlist-video-cursor flatlist-video-cursor-before" aria-hidden="true"></div>
    <img
      src="/images/blog/device-frames/iphone-14-pro-black.png"
      alt=""
      loading="lazy"
      style="position:absolute; inset:0; width:100%; height:100%; pointer-events:none;"
    />
    </div>
  </figure>
  <figure style="margin:0; transform:rotateY(-10deg) rotateX(3deg); transform-style:preserve-3d;">
    <figcaption style="font-weight:700; color:#86efac; margin-bottom:14px; text-align:center;">Після</figcaption>
    <div style="position:relative; max-width:330px; margin:0 auto; aspect-ratio:985/2008; filter:drop-shadow(-32px 34px 46px rgba(0,0,0,0.58));">
    <div style="position:absolute; z-index:3; left:10%; top:5.5%; padding:5px 9px; border-radius:999px; background:rgba(0,0,0,0.68); border:1px solid rgba(255,255,255,0.16); color:#f8fafc; font-size:0.72rem; font-weight:700; pointer-events:none;">▶ відео з симулятора</div>
    <video
      data-autoplay="viewport"
      autoplay
      controls
      playsinline
      muted
      loop
      preload="metadata"
      style="position:absolute; left:5.19%; top:2.17%; width:89.93%; height:95.66%; border-radius:8.8%/4.1%; object-fit:cover; background:#05080f;"
      src="/videos/blog/flatlist-performance/after-release-simplified.mp4"
    >
      Ваш браузер не підтримує тег video.
    </video>
    <div class="flatlist-video-cursor flatlist-video-cursor-after" aria-hidden="true"></div>
    <img
      src="/images/blog/device-frames/iphone-14-pro-black.png"
      alt=""
      loading="lazy"
      style="position:absolute; inset:0; width:100%; height:100%; pointer-events:none;"
    />
    </div>
  </figure>
</div>

У демо на симуляторі старий шлях зростає разом з розміром списку. Для 1k оновлень render-вікна це виглядає так:

- `50k rows`: разом близько `1.92 s` (`1.9196 ms / call`)
- `500k rows`: разом близько `18.78 s` (`18.78 ms / call`)
- `1m rows`: разом близько `38.40 s` (`38.40 ms / call`)

З оптимізованим шляхом те саме демо лишається майже пласким:

- `50k rows`: разом близько `3.74 ms` (`0.0037 ms / call`)
- `500k rows`: разом близько `3.67 ms` (`0.0037 ms / call`)
- `1m rows`: разом близько `3.73 ms` (`0.0037 ms / call`)

Значення на один виклик менші за 1 секунду, тому вони наведені в мілісекундах. Для 1000 оновлень render mask значення понад 1 секунду наведені в секундах.

| Випадок | Одне оновлення до | Одне оновлення після | Прискорення | 1000 оновлень до | 1000 оновлень після |
| --- | ---: | ---: | ---: | ---: | ---: |
| 100k рядків, без sticky headers | 2.664 ms | 0.0034 ms | 780x | 2.66 s | 3.42 ms |
| 100k рядків, порожні sticky headers | 2.632 ms | 0.0033 ms | 800x | 2.63 s | 3.29 ms |
| 100k рядків, один sticky header угорі | 2.705 ms | 0.0054 ms | 499x | 2.71 s | 5.42 ms |
| 250k рядків, без sticky headers | 6.543 ms | 0.0035 ms | 1,892x | 6.54 s | 3.46 ms |
| 250k рядків, порожні sticky headers | 6.579 ms | 0.0033 ms | 2,024x | 6.58 s | 3.25 ms |
| 250k рядків, один sticky header угорі | 6.796 ms | 0.0053 ms | 1,294x | 6.80 s | 5.25 ms |
| 500k рядків, без sticky headers | 13.173 ms | 0.0033 ms | 4,002x | 13.17 s | 3.29 ms |
| 500k рядків, порожні sticky headers | 13.073 ms | 0.0033 ms | 3,997x | 13.07 s | 3.27 ms |
| 500k рядків, один sticky header угорі | 13.444 ms | 0.0054 ms | 2,511x | 13.44 s | 5.35 ms |
| 750k рядків, без sticky headers | 19.524 ms | 0.0033 ms | 6,008x | 19.52 s | 3.25 ms |
| 750k рядків, порожні sticky headers | 19.572 ms | 0.0033 ms | 6,022x | 19.57 s | 3.25 ms |
| 750k рядків, один sticky header угорі | 20.304 ms | 0.0054 ms | 3,778x | 20.30 s | 5.37 ms |
| 1m рядків, без sticky headers | 26.190 ms | 0.0033 ms | 8,058x | 26.19 s | 3.25 ms |
| 1m рядків, порожні sticky headers | 26.039 ms | 0.0033 ms | 8,012x | 26.04 s | 3.25 ms |
| 1m рядків, один sticky header угорі | 26.855 ms | 0.0053 ms | 5,075x | 26.86 s | 5.29 ms |

Стовпчик з 1000 оновлень допомагає краще відчути різницю.

На 1 мільйоні рядків старий шлях без sticky витрачає в цій допоміжній функції близько 26 секунд на 1000 оновлень render mask.

Після зміни той самий випадок займає близько 3.25 ms.

Це час, прибраний зі спільного шляху списків ще до того, як React Native вирішує, які комірки рендерити.

### План тестування

Я хотів, щоб це було нудно в найкращому сенсі: та сама поведінка, менше роботи.

Тож внесок містив тести поведінки та бенчмарки.

Основні команди були такі:

```sh
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
```

```sh
yarn fantom packages/react-native/Libraries/Lists/__tests__/FlatList-itest.js packages/react-native/Libraries/Lists/__tests__/SectionList-itest.js --runInBand
```

```sh
yarn flow check
```

```sh
yarn fantom --benchmarks packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js --runInBand
```

PR змінив три файли:

- реалізацію `VirtualizedList`
- цільові тести `VirtualizedList`
- бенчмарк Fantom для шляху render mask зі sticky headers

Його імпортували через процес Meta і змерджили в `react/react-native`.

### Підсумки

Що мені подобається в цьому внеску: розробникам застосунків нічого не треба робити.

Жодного нового пропса.

Жодної міграції.

Жодних обхідних рішень.

Якщо застосунок використовує великий `FlatList` без sticky headers, React Native тепер може уникнути пошуку sticky headers, який з самого початку був непотрібним.

Це мій улюблений вид покращень фреймворку.

Мала площа змін. Зрозумілий бенчмарк. Жодних змін в API.

І поширений шлях стає дешевшим для всіх.

