كيفية استخدام خاصية files في package.json

في ملف package.json في مشروع Node.js، يُستخدم الخاصية files لتحديد أي الملفات يجب تضمينها عند نشر المكتبة أو التطبيق. إذا لم تكن هناك خاصية files في ملف package.json، فإن Node.js سيأخذ كافة الملفات التي ليست مُستبعدة بواسطة .gitignore أو .npmignore (إذا كانت موجودة) ويضمنها في حزمة النشر.

بمعنى آخر، ليست الخاصية files ضرورية في كل الحالات. إذا أردت تضمين كافة الملفات في المشروع، يمكنك ترك هذه الخاصية فارغة أو إزالتها تمامًا من ملف package.json دون أي تأثير سلبي على عملية النشر.

ومع ذلك، يمكن استخدام الخاصية files لتحديد بعض الملفات المحددة التي يجب تضمينها، وتجاهل الباقي، مما يمنحك تحكمًا أكبر في محتوى الحزمة التي تُنشرها.

الاستخدام الأساسي لخاصية files في ملف package.json هو لتحديد الأنواع المعينة من الملفات التي يجب أن تتضمن في الحزمة التي سيتم نشرها عبر npm. بدلاً من ذلك، يُمكن استخدامها لتحديد مجموعة مُحددة من الملفات المُراد تضمينها، على سبيل المثال:

jsonCopy code
{
  "name": "my-package",
  "version": "1.0.0",
  "files": [
    "dist/",
    "src/",
    "README.md"
  ]
}

في هذا المثال، ستتم تضمين مجلد dist، ومجلد src، وملف README.md فقط في الحزمة التي تُنشأ عند النشر.

من الجدير بالذكر أنه إذا كنت تستخدم Git في مشروعك، فيجب أن تضيف ملف .npmignore أو تعديل ملف .gitignore لاستبعاد الملفات غير المرغوب في تضمينها في الحزمة.