المدونة

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

20 يونيو 2026 9 دقائق للقراءة

كيف جعل طلب الدمج (PR) الذي قدّمته وقُبل في React Native عمل نافذة العرض في FlatList وVirtualizedList أسرع بما يصل إلى 8000 مرة.

جعلت القوائم في React Native أسرع 8000 مرة
React NativeFlatListVirtualizedListالأداءالمصادر المفتوحة

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

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

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

نعيش في زمن تتحرك فيه أخبار الذكاء الاصطناعي بسرعة لدرجة أن شيئًا مثل Claude Fable 5 يمكن أن يُطلق ثم يُعلّق بعد أيام قليلة. والناس يتجادلون حول نماذج تقترب من AGI، وقيود التصدير، والـ agents التي تنجز مشاريع كاملة، وكل ذلك.

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

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

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

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

في أغلب الوقت نكون في جانب التطبيق. نستخدم FlatList وSectionList والتنقل والحركات ومكتبات الحالة وكل الأشياء المعتادة. نشتكي من الأداء، ونجرب بعض الـ props، ونضيف memo، وربما نضيف getItemLayout، ثم نمضي في حياتنا.

لكن أحيانًا تكون المشكلة الحقيقية في طبقة أسفل كود التطبيق.

وهذا ما حدث هنا.

ساهمت بتحسين في الأداء في react/react-native، ودُمج باسم PR #57210. يزيل هذا التغيير عمل البحث غير الضروري عن الترويسات الثابتة (sticky headers) من مسار إنشاء الـ render mask الذي يستخدمه VirtualizedList.

الخط الزمني في GitHub يُظهر دمج طلب تحسين أداء FlatList في React Native
دُمج في React Native. وما زال الأمر يبدو غير حقيقي بعض الشيء.

بكلمات بسيطة: كان React Native أحيانًا يبحث عن ترويسات ثابتة حتى عندما لا تحتوي القائمة على أي ترويسة ثابتة.

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

القائمة: "ليست لدي ترويسات ثابتة."

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

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

  • VirtualizedList
  • FlatList
  • VirtualizedSectionList
  • SectionList

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

هذا جيد.

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

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

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

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

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

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

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

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

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

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

ثم كانت الدالة المساعدة تمشي للخلف بدءًا من أول خلية ظاهرة:

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

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

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

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

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

لماذا يتأثر FlatList

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

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

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

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

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

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

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

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

التغيير

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

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

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

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

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

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:

قبل
▶ فيديو من المحاكي
بعد
▶ فيديو من المحاكي

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

  • 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 ms0.0034 ms780x2.66 s3.42 ms
100 ألف صف، ترويسات ثابتة فارغة2.632 ms0.0033 ms800x2.63 s3.29 ms
100 ألف صف، ترويسة ثابتة واحدة في الأعلى2.705 ms0.0054 ms499x2.71 s5.42 ms
250 ألف صف، بلا ترويسات ثابتة6.543 ms0.0035 ms1,892x6.54 s3.46 ms
250 ألف صف، ترويسات ثابتة فارغة6.579 ms0.0033 ms2,024x6.58 s3.25 ms
250 ألف صف، ترويسة ثابتة واحدة في الأعلى6.796 ms0.0053 ms1,294x6.80 s5.25 ms
500 ألف صف، بلا ترويسات ثابتة13.173 ms0.0033 ms4,002x13.17 s3.29 ms
500 ألف صف، ترويسات ثابتة فارغة13.073 ms0.0033 ms3,997x13.07 s3.27 ms
500 ألف صف، ترويسة ثابتة واحدة في الأعلى13.444 ms0.0054 ms2,511x13.44 s5.35 ms
750 ألف صف، بلا ترويسات ثابتة19.524 ms0.0033 ms6,008x19.52 s3.25 ms
750 ألف صف، ترويسات ثابتة فارغة19.572 ms0.0033 ms6,022x19.57 s3.25 ms
750 ألف صف، ترويسة ثابتة واحدة في الأعلى20.304 ms0.0054 ms3,778x20.30 s5.37 ms
مليون صف، بلا ترويسات ثابتة26.190 ms0.0033 ms8,058x26.19 s3.25 ms
مليون صف، ترويسات ثابتة فارغة26.039 ms0.0033 ms8,012x26.04 s3.25 ms
مليون صف، ترويسة ثابتة واحدة في الأعلى26.855 ms0.0053 ms5,075x26.86 s5.29 ms

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

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

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

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

خطة الاختبار

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

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

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

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 ثلاثة ملفات:

  • تنفيذ VirtualizedList
  • اختبارات مركّزة لـ VirtualizedList
  • benchmark في Fantom لمسار الـ render mask الخاص بالترويسات الثابتة

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

أفكار أخيرة

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

لا prop جديد.

لا ترحيل.

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

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

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

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

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