# جعلت القوائم في React Native أسرع 8000 مرة

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

نعم، قرأتها صحيحًا: أسرع 8000 مرة.

لا أقصد أن "تطبيقك كله أصبح أسرع 8000 مرة، اذهب واشترِ يختًا". للأسف.

ونعم أيضًا، أعرف أن التوقيت مضحك.

نعيش في زمن تتحرك فيه أخبار الذكاء الاصطناعي بسرعة لدرجة أن شيئًا مثل [Claude Fable 5 يمكن أن يُطلق ثم يُعلّق بعد أيام قليلة](https://www.anthropic.com/news/claude-fable-5-mythos-5). والناس يتجادلون حول نماذج تقترب من AGI، وقيود التصدير، والـ agents التي تنجز مشاريع كاملة، وكل ذلك.

وها أنا أتحدث عن جعل القوائم في React Native أسرع.

يبدو الأمر غريبًا بعض الشيء عندما تضع هذين الأمرين جنبًا إلى جنب. أفهم ذلك.

لكنني ما زلت أجد هذا النوع من العمل مثيرًا. ربما تكون كلمة "اختراع" أكبر من اللازم، لكن تحسين إطار عمل تستخدمه آلاف التطبيقات ما زال يعني لي الكثير. ليس كل شيء مفيد يجب أن يبدو كالخيال العلمي. أحيانًا يكون مجرد إزالة عمل مهدر من مسار يمر به تقريبًا كل تطبيق للهاتف.

المكسب موجود في مسار محدد واحد للقوائم في React Native: عمل نافذة العرض (render window) الذي يقرر أي الخلايا يجب أن توجد الآن. في هذا الـ benchmark، كان المسار القديم قد يهدر ثواني كاملة مع القوائم الضخمة، والمسار الجديد يقلص ذلك إلى بضع ميلي ثانية.

في أغلب الوقت نكون في جانب التطبيق. نستخدم `FlatList` و`SectionList` والتنقل والحركات ومكتبات الحالة وكل الأشياء المعتادة. نشتكي من الأداء، ونجرب بعض الـ props، ونضيف `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 يُظهر دمج طلب تحسين أداء 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 أحيانًا يبحث عن ترويسات ثابتة حتى عندما لا تحتوي القائمة على أي ترويسة ثابتة.

لحظة حاسوبية كلاسيكية.

> القائمة: "ليست لدي ترويسات ثابتة."
>
> React Native: "رائع، دعني أبحث للخلف لأجد واحدة."

الجميل أن هذا المسار مشترك. لذا يؤثر التحسين في:

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

ونعم، الاستخدام العادي لـ `FlatList` يمكن أن يستفيد حتى لو لم تكن تستخدم الترويسات الثابتة إطلاقًا.

### ما الذي يحسّنه هذا فعلًا

قبل الدخول في الكود، من المفيد أن نوضح نوع الأداء الذي نتحدث عنه.

التحسين في عمل JavaScript الذي يقوم به React Native قبل أن يقرر أي الصفوف يجب أن تُعرض.

يحتفظ `FlatList` بنافذة عرض. أثناء التمرير أو القفز أو التركيب قرب فهرس ابتدائي أو التنقل داخل قائمة كبيرة، يحتاج React Native إلى أن يقرر أي الخلايا يجب أن تُعرض وأي الأجزاء يمكن أن تبقى مساحات فارغة (spacers).

هذا القرار يمر عبر `VirtualizedList._createRenderMask`.

إذن المكسب هو:

- عمل JS أقل أثناء تحديثات نافذة القائمة
- عمل أقل عند القفز قرب نهاية قائمة ضخمة
- منطق أقل غير ضروري للترويسات الثابتة في القوائم التي لا تحتوي عليها
- قرارات أسرع قبل أن تحدّث القائمة ما يجب أن يظهر على الشاشة

بلغة التطبيقات العادية، يساعد هذا الجزء من `FlatList` الذي يقرر "أي الصفوف يجب أن توجد الآن؟"

في القوائم الكبيرة جدًا، خاصة قرب نهاية القائمة، قد يصبح هذا القرار الداخلي الصغير كلفة حقيقية.

وإزالة هذه الكلفة تجعل مسار تحديث نافذة العرض أقل كلفة بكثير.

### الشيء الذي لاحظته

`FlatList` من المكونات التي يستخدمها تقريبًا كل تطبيق React Native في مرحلة ما.

يبدو بسيطًا من الخارج:

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

لكنه من الداخل يمر عبر `VirtualizedList`.

لا يعرض `VirtualizedList` مصدر البيانات كاملًا. إذا كان لديك 100 ألف صف، فلن يضع 100 ألف صف على الشاشة مثل جندي شجاع لكنه محكوم بالهلاك. بل يحتفظ بنافذة عرض ويستخدم render mask ليقرر أي الخلايا يجب أن توجد الآن.

هذا جيد.

المشكلة كانت داخل خطوة إنشاء الـ render mask.

يدعم React Native أيضًا الترويسات الثابتة. وهي حالة خاصة لأن العنصر الثابت قد يكون خارج منطقة العرض العادية، لكن يجب أن يبقى معروضًا لأنه بصريًا ملتصق في الأعلى.

لذا يحتاج React Native إلى منطق مثل:

"ابحث عن أقرب ترويسة ثابتة قبل منطقة العرض وأبقِها معروضة."

هذا المنطق صحيح.

الجزء المزعج أن البحث قد يعمل حتى عندما لا توجد ترويسات ثابتة.

### المسار القديم

قبل هذا التغيير، كان `VirtualizedList._createRenderMask` يبني set من `stickyHeaderIndices` ويستدعي الدالة المساعدة الخاصة بالترويسات الثابتة.

النسخة المبسطة كانت تبدو هكذا:

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

مع قائمة صغيرة، لا يهم هذا.

لكن مع قائمة كبيرة جدًا يصبح مؤلمًا. إذا كانت منطقة العرض قرب نهاية قائمة من مليون صف، ولا توجد ترويسات ثابتة، فقد تمشي الدالة المساعدة للخلف عبر القائمة كلها تقريبًا.

وهذا في الأساس بحث كبير للعثور على لا شيء.

ليست هوايتي المفضلة.

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

### لماذا يتأثر FlatList

هذا الجزء يسهل أن يفوتك.

لا تحتاج إلى استخدام `VirtualizedList` مباشرة. فـ `FlatList` مبني فوقه.

لذا فإن كودًا كهذا:

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

ما زال يمر عبر `VirtualizedList._createRenderMask`.

قبل التغيير، كانت قائمة عادية بلا `stickyHeaderIndices` قد تدفع كلفة عمل البحث عن الترويسات الثابتة.

بعد التغيير، يتحقق React Native مما إذا كانت الترويسات الثابتة موجودة فعلًا قبل القيام بأي عمل خاص بها.

تقنية متقدمة جدًا: تحقق من وجود الشيء قبل البحث عنه.

### التغيير

الجزء الأول هو المهم في الاستخدام العادي لـ `FlatList` بلا ترويسات ثابتة.

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

إذا لم توجد ترويسات ثابتة، نتخطى الدالة المساعدة.

والجزء الثاني يحسّن حالة الترويسات الثابتة أيضًا.

بدل المشي للخلف عبر فهارس العناصر، تفحص الدالة المساعدة فهارس الترويسات الثابتة المضبوطة وتجد أقرب ترويسة ثابتة صالحة قبل منطقة العرض.

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

إذن تتغير الكلفة من:

"كم نبعد عن بداية القائمة؟"

إلى:

"كم عدد الترويسات الثابتة المضبوطة؟"

وهذا سؤال أفضل بكثير.

### الحفاظ على السلوك نفسه

هذا هو الجزء الذي يجعل التغييرات الصغيرة في أطر العمل أقل صغرًا مما تبدو.

لا يمكنك أن تحسّن الأداء وتأمل أن كل شيء سيكون على ما يرام. قد تكون `stickyHeaderIndices` غير مرتبة. وقد تحتوي على قيم مكررة. وقد تحتوي على قيم غير صالحة. وقد يوجد `ListHeaderComponent` يزيح الفهرس بمقدار واحد.

كل ذلك يجب أن يبقى عاملًا.

تغطي الاختبارات حالات مثل:

- عدم وجود `stickyHeaderIndices`
- `stickyHeaderIndices` فارغة
- فهارس ثابتة غير مرتبة
- فهارس ثابتة مكررة
- قيم سالبة
- قيم كسرية
- قيم بعد منطقة العرض
- التعامل مع الإزاحة التي يسببها `ListHeaderComponent`

الحالة الأخيرة مهمة. فهارس الترويسات الثابتة تعتمد على فهارس الأبناء في الـ `ScrollView` الأساسي. وعندما توجد ترويسة للقائمة، لا يعود فهرس العنصر `0` هو فهرس الابن `0`.

أخطاء الفرق بواحد (off-by-one) تحب هذه المنطقة. تسكن فيها بلا إيجار.

### نتائج الـ Benchmark

قست أداء مسار `VirtualizedList._createRenderMask` مباشرة باستخدام Fantom Hermes، بـ 100 عينة لكل حالة.

يركز هذا الـ benchmark على عمل قرار نافذة العرض داخل `VirtualizedList`.

لذا لا، هذا لا يعني أن كل `FlatList` في كل تطبيق أصبح فجأة يُمرَّر أسرع 8000 مرة. أتمنى ذلك. كنت سأصبح لا أُطاق بسببه.

المعنى أن هذا المسار الداخلي المحدد لتقسيم القائمة إلى نوافذ أصبح أقل كلفة بشكل هائل. وعندما ينتقل الـ benchmark من ثوانٍ من العمل المهدر إلى بضع ميلي ثانية، فهذا مكسب حقيقي جدًا.

### الإثبات على المحاكي

أنشأت أيضًا تطبيق React Native صغيرًا من نوع bare لأقارن التنفيذين على محاكي iOS.

التطبيق نفسه. والـ `FlatList` نفسه بـ `1m` صف. والإعداد نفسه `no sticky headers`.

الفرق الوحيد هو تنفيذ `VirtualizedList` المثبّت. هذه تسجيلات حقيقية من المحاكي داخل إطارات الهاتف، وليست لقطات شاشة ثابتة لنماذج تصميم. تركت أزرار التحكم في الفيديو ظاهرة عمدًا، ونبضة المؤشر تحدد لحظة الضغط على زر الـ benchmark.

اختبارات الـ benchmark والسلوك موجودة أيضًا في الـ PR المدموج في React Native:

- [اختبار الـ benchmark في 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>
    <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>
    <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>

في العرض على المحاكي، ينمو زمن المسار القديم مع حجم القائمة. مع ألف تحديث لنافذة العرض، يبدو الأمر هكذا:

- `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,000 تحديث للـ render mask، فالقيم التي تتجاوز ثانية واحدة تظهر بالثواني.

| الحالة | تحديث واحد قبل | تحديث واحد بعد | التسريع | 1,000 تحديث قبل | 1,000 تحديث بعد |
| --- | ---: | ---: | ---: | ---: | ---: |
| 100 ألف صف، بلا ترويسات ثابتة | 2.664 ms | 0.0034 ms | 780x | 2.66 s | 3.42 ms |
| 100 ألف صف، ترويسات ثابتة فارغة | 2.632 ms | 0.0033 ms | 800x | 2.63 s | 3.29 ms |
| 100 ألف صف، ترويسة ثابتة واحدة في الأعلى | 2.705 ms | 0.0054 ms | 499x | 2.71 s | 5.42 ms |
| 250 ألف صف، بلا ترويسات ثابتة | 6.543 ms | 0.0035 ms | 1,892x | 6.54 s | 3.46 ms |
| 250 ألف صف، ترويسات ثابتة فارغة | 6.579 ms | 0.0033 ms | 2,024x | 6.58 s | 3.25 ms |
| 250 ألف صف، ترويسة ثابتة واحدة في الأعلى | 6.796 ms | 0.0053 ms | 1,294x | 6.80 s | 5.25 ms |
| 500 ألف صف، بلا ترويسات ثابتة | 13.173 ms | 0.0033 ms | 4,002x | 13.17 s | 3.29 ms |
| 500 ألف صف، ترويسات ثابتة فارغة | 13.073 ms | 0.0033 ms | 3,997x | 13.07 s | 3.27 ms |
| 500 ألف صف، ترويسة ثابتة واحدة في الأعلى | 13.444 ms | 0.0054 ms | 2,511x | 13.44 s | 5.35 ms |
| 750 ألف صف، بلا ترويسات ثابتة | 19.524 ms | 0.0033 ms | 6,008x | 19.52 s | 3.25 ms |
| 750 ألف صف، ترويسات ثابتة فارغة | 19.572 ms | 0.0033 ms | 6,022x | 19.57 s | 3.25 ms |
| 750 ألف صف، ترويسة ثابتة واحدة في الأعلى | 20.304 ms | 0.0054 ms | 3,778x | 20.30 s | 5.37 ms |
| مليون صف، بلا ترويسات ثابتة | 26.190 ms | 0.0033 ms | 8,058x | 26.19 s | 3.25 ms |
| مليون صف، ترويسات ثابتة فارغة | 26.039 ms | 0.0033 ms | 8,012x | 26.04 s | 3.25 ms |
| مليون صف، ترويسة ثابتة واحدة في الأعلى | 26.855 ms | 0.0053 ms | 5,075x | 26.86 s | 5.29 ms |

عمود الألف تحديث يجعل الفرق أسهل في الإحساس به.

مع مليون صف، يقضي المسار القديم بلا ترويسات ثابتة نحو 26 ثانية في هذه الدالة المساعدة مقابل 1,000 تحديث للـ render mask.

بعد التغيير، تستغرق الحالة نفسها نحو 3.25 ms.

هذا وقت أُزيل من مسار مشترك للقوائم قبل أن يقرر React Native أي الخلايا يجب أن تُعرض.

### خطة الاختبار

أردت أن يكون هذا مملًا بأفضل معنى للكلمة: السلوك نفسه، وعمل أقل.

لذا تضمنت المساهمة اختبارات للسلوك وتغطية بالـ benchmark.

الأوامر الرئيسية كانت:

```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`
- benchmark في Fantom لمسار الـ render mask الخاص بالترويسات الثابتة

استُورد عبر الإجراءات المتبعة في Meta ودُمج في `react/react-native`.

### أفكار أخيرة

ما يعجبني في هذه المساهمة أن مطوري التطبيقات لا يحتاجون إلى فعل أي شيء.

لا prop جديد.

لا ترحيل.

لا حلول التفافية.

إذا كان تطبيق ما يستخدم `FlatList` كبيرًا بلا ترويسات ثابتة، فيمكن لـ React Native الآن أن يتجنب عمل البحث عن الترويسات الثابتة الذي لم يكن ضروريًا أصلًا.

هذا نوعي المفضل من تحسينات أطر العمل.

مساحة تغيير صغيرة. benchmark واضح. لا تغيير في الـ API.

ومسار شائع يصبح أقل كلفة للجميع.

