استخدام حزمة NPM
شاهد
Using the Obfuscator.io API: API Keys, npm Package, CLI and Custom Presets
ترسل الحزمة البناء إلى واجهة API لخدمة obfuscator.io، لذا تحتاج إلى مفتاح API (Pro أو Team أو Business) يُمرَّر عبر apiToken، أو عبر --pro-api-token في CLI. أما إنشاء المفاتيح ومفاتيح خدمة الفريق وإبقاؤها خارج كود المتصفح فمشروح في مرجع API.
npm
production.json
Node.js (.mjs)
CLI
الحصة
تقرأ حزمة javascript-obfuscator بإصدار 5.9.0 أو أحدث الاستخدامَ المتبقي في خطتك عبر getProQuota، كي يتحقق البناء قبل أن يبدأ من أن ملفاته تتسع ضمن المتبقي، بدلًا من أن يفشل في منتصف الطريق. تُحتسب عملية البناء بحجم مصدرها بالبايت (UTF-8)، وبحد أدنى قدره minBytesPerBuild؛ ولا يُحتسب حجم الناتج. عندما يُرفض بناء لأن أحد الحدود قد استُنفد، يُرمى خطأ ApiError قيمة الحقل code فيه dailyLimit أو monthlyLimit، ويشير resetsAt الخاص بتلك النافذة الزمنية إلى موعد بدئها من جديد. وجميع الحقول موصوفة في مرجع API.
Node.js (.mjs) مع التحقق من الحصة
الإعدادات المسبقة المخصصة
احتفظ بالإعدادات في لوحة التحكم بدلًا من ملف إعدادات: احفظ الخيارات الحالية كإعداد مسبق مخصص، وامنحه اسمًا مستعارًا لواجهة API في نافذة الحفظ، ثم اضبط optionsPreset على هذا الاسم المستعار. تجلب حزمة javascript-obfuscator بإصدار 5.8.0 أو أحدث الإعداد المسبق قبل التشويش، فأي تغيير في لوحة التحكم يسري على البناء التالي دون أي إيداع في المستودع. خيارات الإعداد المسبق هي الأساس، وأي خيار آخر في إعداداتك يتجاوزها، تمامًا كما تُدمج الإعدادات المسبقة المدمجة. يعيد مفتاح خدمة الفريق الإعدادات المسبقة لمالك الفريق، بينما يعيد مفتاح API الخاص بالعضو إعداداته الخاصة إضافةً إلى ما شاركه المالك مع الفريق.
Node.js (.mjs) مع إعداد مسبق
CLI مع إعداد مسبق
يؤدي وضع "optionsPreset": "production" في production.json الغرض نفسه لبناء يستخدم --config. الأسماء المدمجة مثل vm-default لا يُبحث عنها أبدًا كأسماء مستعارة. الاسم المستعار غير الموجود لديك يفشل مع الحالة HTTP 404 قبل إرسال أي مصدر، والإعداد المسبق المخصص الذي لا يفعّل أي ميزة Pro يُشوَّش محليًا بخياراته.
الإعداد المسبق عبر REST
يمكن لتكامل REST المباشر ذكر الاسم المستعار نفسه في optionsPreset ضمن طلب التشويش، ويحلّه الخادم بالطريقة نفسها. ولقراءة خيارات إعداد مسبق دون تشويش، استخدم نقطة نهاية الإعدادات المسبقة. وكلاهما موثق في مرجع API. تجلب حزمة javascript-obfuscator الإعداد المسبق مرة واحدة لكل تشغيل، ويُحتسب هذا الطلب ضمن حد المعدل نفسه لكل مستخدم الذي تُحتسب فيه طلبات التشويش.
حدود المعدل وسلوك الرفع الكبير موضحة في مرجع API، وتظهر حدود خطتك في لوحة التحكم؛ وتنتقل الحزمة تلقائيًا إلى الرفع المؤقت للمصادر الكبيرة في خطتي Team وBusiness.