FFI في Node.js 26: مات node-gyp، ووُلد الانهيار الصامت

لسنوات، كان أسوأ ما في تثبيت حزمة Node.js ليس الحزمة نفسها، بل السطر الذي يظهر فجأة في منتصف npm install: محاولة بناء إضافة أصلية (Native Addon)، ثم شلّال أخطاء عن مترجم مفقود أو نسخة بايثون غير مناسبة. أداة node-gyp صارت في ذهن كثير من المطوّرين مرادفاً للمعاناة.

في Node.js 26.9.0 الصادرة في 16 سبتمبر 2026، صار بإمكان جافاسكربت أن تستدعي مكتبة أصلية جاهزة مباشرة — ملف .so أو .dylib أو .dll — دون كتابة سطر C++ واحد ودون أي خطوة بناء. الميزة اسمها FFI (واجهة الاستدعاء الأجنبي)، وصارت مفعّلة افتراضياً في البناء الرسمي.

الخبر يُقرأ عادة كخبر راحة: انتهى عذاب node-gyp. لكن القراءة الأدقّ أنه نقل للخطر، لا إلغاء له — وهذا بالضبط ما يجب أن تفهمه قبل أن تضع سطر FFI في خدمة إنتاج.

ما الذي تغيّر فعلاً

الإضافة الأصلية التقليدية كانت تعني: كود C++ وسيط، وملف binding.gyp، وعملية ترجمة تحدث على جهاز كل مطوّر وفي كل خادم بناء. مع FFI تختفي هذه الطبقة بالكامل: تصف لـ Node اسم المكتبة واسم الدالة وأنواع مُعاملاتها، فيتولّى هو تحويل القيم بين عالم جافاسكربت وعالم C.

المكسب واضح في حالات محدّدة: مكتبة تشفير أو ضغط أو معالجة صور موجودة أصلاً على النظام، تريد استدعاءها دون بناء غلاف كامل حولها. ومعها وصلت في النسخة نفسها إضافات أخرى: دعم من الدرجة الأولى لـ Web Workers داخل خيوط العمل بأسلوب المتصفّح (postMessage/onmessage)، وواجهة DTLS تجريبية، وإصلاح أمني يمنع Hmac.digest() من إعادة ذاكرة غير مهيّأة.

التفصيلة التي تلخّص حالة الإصدار

في الإصدار نفسه شُحنت وحدة قياس أداء مدمجة باسم node:bench — ثم أُعيدت سريعاً خلف راية --experimental-bench بعد ملاحظات المراجعة على موثوقية القياس وسياسة تحديد الفروق ذات الدلالة.

هذه التفصيلة الصغيرة هي أصدق وصف لحالة النسخة 26 اليوم: خطّ Current لا LTS. الانتقال إلى الدعم طويل الأمد متوقّع في أكتوبر 2026، وحتى ذلك الحين فهذه نسخة للتجريب والاختبار، لا لتثبيتها تحت خدمة يعتمد عليها عملاؤك.

الفخّ: من خطأ بناء صاخب إلى انهيار صامت

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

أما خطأ FFI فيقع في وقت التشغيل، وداخل ذاكرة العملية. وتوثيق Node نفسه لا يجامل في وصف ذلك: الواجهة غير آمنة بطبيعتها، وتمرير مؤشّر غير صالح أو توصيف خاطئ لتوقيع الدالة أو الوصول إلى ذاكرة محرّرة قد يُسقط العملية أو يُفسد الذاكرة.

الفرق الجوهري: خطأ node-gyp كان يمنعك من تشغيل التطبيق. خطأ FFI يترك التطبيق يعمل — ثم ينهار لاحقاً، أو أسوأ: لا ينهار ويعطي نتائج خاطئة.

وهذا يعني أن try/catch لا ينفعك هنا. انهيار على مستوى الذاكرة ليس استثناءً في جافاسكربت يمكن التقاطه؛ إنه موت للعملية بأكملها، يأخذ معه كل الطلبات التي كانت تُخدَم في تلك اللحظة.

مزالق موثَّقة تستحقّ الحفظ

المزلق	ما يحدث فعلاً
مؤشّر قديم (Stale Pointer)	الوحدة لا تتتبّع صلاحية المؤشّرات ولا ملكية الذاكرة إطلاقاً
تعديل مخزن البيانات أثناء استدعاء نشط	تغيير حجمه أو نقله أو فصله — بما في ذلك عبر ردود نداء FFI — غير مدعوم وخطير
استدعاء رد نداء بعد library.close()	سلوك غير معرّف: انهيار أو نتائج خاطئة أو إفساد ذاكرة
افتراض ملكية القيمة المُعادة	إعادة مؤشّر لا تعني أنك تملكه؛ من يحرّره تحدّده المكتبة الأصلية وحدها
تمرير true لمُعامل من نوع bool	يُحوَّل كعدد صحيح 8-بت — مرّر 0 أو 1، والقيم المنطقية غير مقبولة

المزلق الأخير يستحقّ وقفة لأنه أخبث ما في القائمة: ليس انهياراً مدوّياً بل خطأ في النوع يمرّ بهدوء. والشيء نفسه ينطبق على char، فهو يتبع معيار المنصّة — مؤشّر صحيح بإشارة على منصّة، وبلا إشارة على أخرى.

البعد الأمني: راية واحدة تفتح كل شيء

نقطة يجب أن يقرأها كل من يشغّل كوداً لا يملكه بالكامل.

Node يملك نموذج صلاحيات تجريبياً يقيّد ما تستطيع العملية فعله — الملفات، الشبكة، تشغيل العمليات، الإضافات الأصلية. وFFI مُدرَج ضمن هذه القيود: مع --permission تُرفَض استدعاءات FFI بخطأ ERR_ACCESS_DENIED ما لم تمرّر --allow-ffi صراحةً.

المهمّ أن --allow-ffi ليست صلاحية جزئية. الكود الذي يستطيع تحميل أي مكتبة نظام واستدعاء أي رمز فيها يستطيع عملياً فعل أي شيء يفعله المستخدم المشغِّل للعملية — بغضّ النظر عن باقي القيود. وفريق Node وثّق هذا صراحةً بتغيير يضع FFI ضمن ما يُعدّ موثوقاً في نموذج التهديد، أي: خارج نطاق ما يَعِد الصندوق الرملي بحمايته.

عملياً، تمرير --allow-ffi لتشغيل اعتمادية واحدة تحتاجها يعني إسقاط الفائدة الأمنية من --permission كلّها. لا يوجد وضع وسط.

كيف تتعامل معها الآن: خمس خطوات

1. لا تضعها في الإنتاج قبل LTS. النسخة 26 على خطّ Current حتى أكتوبر. أي شيء في مسار إيراداتك ينتظر.
2. قِس قبل أن تهاجر. تحويل القيم بين جافاسكربت وC ليس مجانياً. لاستدعاءات قصيرة ومتكرّرة قد يبتلع هذا التحويل المكسب كاملاً، بل ويصير أبطأ من كود جافاسكربت خالص. الاستدعاء الذي يستحقّ FFI هو الثقيل النادر، لا الخفيف المتكرّر.
3. اعزل حدود FFI في وحدة واحدة. ملف واحد يعرّف كل التواقيع والأنواع، والباقي يستدعي دواله فقط. هذا يجعل مراجعة الأخطر في تطبيقك مراجعة ملف واحد.
4. ثبّت الأنواع في اختبار. توقيع دالة يتغيّر في نسخة جديدة من المكتبة الأصلية لن ينتج خطأ ترجمة يوقفك — سينتج انهياراً في الإنتاج. اختبار يستدعي كل دالة بقيم معروفة ويتحقّق من النتيجة هو شبكة الأمان الوحيدة المتاحة.
5. راقب انهيار العملية، لا الاستثناءات فقط. أضف تتبّعاً لإعادة تشغيل العملية ولإشارات الخروج غير الطبيعية؛ فهذه — لا سجلّات الأخطاء — هي المكان الذي ستظهر فيه أخطاء FFI.

أسئلة شائعة

هل يعني هذا نهاية الإضافات الأصلية وnode-gyp؟

لا. FFI ممتازة لاستدعاء مكتبة جاهزة بواجهة C واضحة، لكنها ليست بديلاً عن إضافة أصلية حين تحتاج منطقاً وسيطاً حقيقياً، أو تعاملاً مباشراً مع محرّك V8، أو أداءً يتطلّب تقليل عبور الحدود بين العالمين. المشاريع الكبرى ستبقى على الإضافات الأصلية.

هل FFI أسرع دائماً من كود جافاسكربت؟

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

هل أنا مضطرّ للترقية الآن؟

لا. إن كنت على نسخة LTS مدعومة ولا تعاني من مشكلة يحلّها FFI تحديداً، فالانتظار حتى أكتوبر هو القرار الصحيح. والترقية حين تحدث لا تعني استخدام FFI — الميزة متاحة، وليست مفروضة.

الخلاصة

تفعيل FFI افتراضياً في Node.js 26.9.0 تغيير حقيقي في علاقة جافاسكربت بالعالم الأصلي، لكنه ليس التبسيط الذي يبدو عليه من العنوان. ما حدث هو أن فئة كاملة من الأخطاء انتقلت من وقت التثبيت — حيث كانت صاخبة ومزعجة وأمامك مباشرة — إلى وقت التشغيل، حيث تصير صامتة وخطيرة وبعيدة عنك.

الإضافة الأصلية كانت تعاقبك مبكراً. FFI تصدّقك، وتترك الحساب لوقت لاحق.

القرار العملي اليوم: جرّبها على خطّ Current واعرف ما تصلح له، وأبقِ الإنتاج على LTS حتى أكتوبر. وحين تستخدمها، تعامل مع كل توقيع دالة تكتبه باعتباره كوداً أصلياً غير آمن — لأنه بالضبط ما هو عليه.