عن المشروع

تُعد fs-extra مكتبة شاملة لـ Node.js تعزز الوحدة الأصلية `fs` من خلال إضافة عمليات نظام الملفات الشائعة ودعم كامل للوعد (Promise). صُممت لتكون بديلاً مباشراً، مما يعني أنها تتضمن جميع طرق `fs` القياسية بالإضافة إلى أدوات جديدة. تشمل القدرات الرئيسية النسخ المتكرر للملفات (`copy`)، والحذف المتكرر (`remove`)، وضمان وجود الملف/المجلد (`ensureFile`, `ensureDir`)، وإنشاء المجلدات بشكل متكرر (`mkdirs`, `mkdirp`). كما توفر أدوات لكتابة الملفات مع إنشاء الدلائل الأب تلقائياً (`outputFile`)، ونقل الملفات (`move`)، والتعامل مع بيانات JSON مباشرةً (`readJson`, `writeJson`, `outputJson`). تُرجع جميع الطرق غير المتزامنة وعودات الأوامر (Promises) وتدعم الاستدعاءات الخلفية (Callbacks)، بينما تتوفر نظائر متزامنة (مثل `copySync`) للعمليات العرقلة. للحفاظ على سلامة عمليات ملفات الحجم الكبير، تعتمد fs-extra على `graceful-fs` لتجنب أخطاء `EMFILE`. تدعم المكتبة استيراد كل من CommonJS وES Module. يتضمن المشروع اختبارات واسعة، ويتبع نمط JavaScript القياسي، ولديه بيئة غنية من الأدوات الخارجية مثل واجهة سطر الأوامر (CLI) وتعريفات TypeScript.