skill
أفضل ممارسات العمال
أفضل ممارسات Cloudflare Workers لتطبيقات الإنتاج. تستخدم عند كتابة Workers أو مراجعتها أو تهيئتها.
نبذة
قد تكون معرفتك بواجهات برمجة تطبيقات Cloudflare Workers وأنواعها وتكوينها قديمة. **فضل الاسترجاع على التدريب المسبق** عند كتابة أو مراجعة كود Workers.
استخدم الإصدارات المثبتة للمشروع، والأنواع المنشأة، وإعدادات توافق Wrangler كأساس للكود الحالي. استرجع وثائق Cloudflare ذات الصلة للتحقق من واجهة برمجة التطبيقات (API)، والتكوين، وسلوك وقت التشغيل، ومطالبات الحدود.
## المراجع
اقرأ الأقسام ذات الصلة بالمهمة:
| المرجع | متى يتم استخدامه | |-----------|----------------| | [التكوين وإمكانية المراقبة](references/configuration.md) | تواريخ التوافق، والروابط (bindings)، والأنواع المنشأة، والأسرار، والسجلات، والتتبع | | [أنماط وقت التشغيل](references/runtime-patterns.md) | البث (streaming)، وعمر ال promise، وحالة الطلب، واستدعاءات الخدمة، والأمان، واختبارات وقت التشغيل | | [فحوصات واجهة برمجة تطبيقات المنصة](references/platform-apis.md) | توقيعات المعالجات (handler signatures)، وفئات المنصة، والوصول إلى الروابط، والتسلسل |
للحصول على أدلة مفقودة، استشر [أفضل ممارسات Workers](https://developers.cloudflare.com/workers/best-practices/workers-best-practices/index.md) أو ابحث عن المنتج المتأثر في [دليل وثائق Cloudflare](https://developers.cloudflare.com/directory/index.md). استخدم مخطط Wrangler المثبت لحقول التكوين. لا تحل حزمة أنواع أحدث محل الهدف المكون للمشروع.
## حافظ على تواريخ التوافق محدثة
استخدم تاريخ اليوم ل Workers الجديدة. شجع التحديثات الدورية ل Workers الحالية، مع مراجعة تغييرات التوافق وتشغيل الاختبارات ذات الصلة. قم بتقييم السلوك الحالي مقابل تاريخه وعلاماته المكونة؛ راجع [إرشادات التوافق](references/configuration.md#keep-compatibility_date-current).
## تمكين إمكانية المراقبة
قم بتمكين [سجلات Workers](https://developers.cloudflare.com/workers/observability/logs/workers-logs/index.md) و[التتبع](https://developers.cloudflare.com/workers/observability/traces/index.md) عند إنشاء أو إعداد Worker للإنتاج. اضبط `observability.enabled` و`observability.traces.enabled` على `true`؛ الإعداد العلوي وحده لا يمكن التتبع. استخدم تسجيل JSON المهيكل وقم بتكوين أخذ العينات (sampling) لعبء العمل. أثناء المراجعات، ضع علامة على السجلات أو التتبعات المفقودة. راجع [مثال التكوين](references/configuration.md#enable-workers-logs-and-traces).
## ضع الحوسبة بالقرب من قواعد البيانات الإقليمية
بالنسبة ل Workers التي تجري استعلامات متسلسلة متعددة لقاعدة بيانات إقليمية واحدة، قم بتكوين موضع صريح يطابق مزود قاعدة البيانات ومنطقتها قبل النشر. اطلب معلومات الموقع المفقودة، واحتفظ بخيارات الموضع الحالية، وتحقق من أهلية المعالج ومدة الطلب المنشور. راجع [وضع قاعدة البيانات](references/configuration.md#place-compute-near-regional-databases).
## الأنماط المضادة التي يجب وضع علامة عليها
| النمط المضاد | النتيجة والنمط المفضل | |-------------|-----------------------------------| | `await response.text()` أو تخزين مؤقت مشابه للبيانات غير المحدودة | يمكن أن يستنفد ذاكرة Worker؛ [قم ببث الأجسام الكبيرة أو غير المحدودة](references/runtime-patterns.md#stream-request-and-response-bodies). | | أسرار مبرمجة بشكل ثابت في المصدر أو التكوين | تسرب بيانات الاعتماد من خلال التحكم في الإصدار؛ استخدم أسرار Wrangler. | | `Math.random()` للرموز أو المعرفات الحساسة للأمان | قيم يمكن التنبؤ بها؛ استخدم `crypto.randomUUID()` أو `crypto.getRandomValues()`. | | عمل غير متزامن بدأ دون انتظار، أو إرجاع، أو إرفاقه ب `ctx.waitUntil()` | يمكن إسقاط العمل وتفويت الأخطاء؛ اربطه بعمر الطلب أو العمل في الخلفية. | | حالة طلب قابلة للتغيير على مستوى الوحدة | تسرب البيانات عبر الطلبات ويمكن أن يسبب أخطاء ملكية الإدخال/الإخراج؛ مرر حالة الطلب بشكل صريح. | | استدعاءات Cloudflare REST API للعمليات المتاحة من خلال روابط Worker | يضيف حملا زائدا على الشبكة والمصادقة؛ استخدم الرابط المتاح. | | `ctx.passThroughOnException()` المستخدم كمعالجة عامة للأخطاء | يمكن أن يخفي فشل Worker عن طريق إعادة التوجيه إلى المصدر؛ استخدم معالجة الأخطاء الصريحة واستجابات الأخطاء المهيكلة. | | `Env` مكتوب يدويا يكرر روابط Wrangler | يمكن أن ينجرف عن التكوين؛ قم بإنشاء أنواع الروابط باستخدام `wrangler types`. | | مقارنة السلسلة المباشرة للقيم السرية | يمكن أن يكشف عن اختلافات التوقيت؛ استخدم [نمط مقارنة Web Crypto](references/runtime-patterns.md#use-web-crypto-for-secure-token-generation). | | تفكيك طرق `ctx`، مثل `const { waitUntil } = ctx` | يفقد المستقبل؛ استدع `ctx.waitUntil(...)`. | | `any` على `Env` أو معلمات المعالج | يخفي أخطاء الروابط وعقد المعالج؛ استخدم الأنواع المنشأة للمشروع وأنواع المنصة. | | `as unknown as T` لفرض تطابق نوع المنصة | يخفي عدم التوافق؛ قم بإصلاح العقد الأساسي. | | `implements` المستخدم بدلا من تمديد فئة أساسية للمنصة | لا يرث سلوك وقت التشغيل، أو `this.ctx`، أو `this.env`؛ استخدم الفئة الأساسية المناسبة. | | `env.X` غير المرتبط في طريقة فئة المنصة | الروابط متاحة من خلال `this.env.X`؛ راجع [أنماط الوصول إلى الروابط](references/platform-apis.md#binding-access--the-most-common-error). | | تطبيق تسلسل واحد |
التثبيت
شغل هذا الأمر
npx skills add cloudflare/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add cloudflare/skills`، أو استنسخ المستودع وانسخ مجلد `skills/workers-best-practices` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة أفضل ممارسات العمال؟
أفضل ممارسات Cloudflare Workers لتطبيقات الإنتاج. تستخدم عند كتابة Workers أو مراجعتها أو تهيئتها.
كيف أثبت أفضل ممارسات العمال؟
شغل هذا الأمر في الطرفية:
npx skills add cloudflare/skillsمع أي أدوات ذكاء اصطناعي تعمل أفضل ممارسات العمال؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور أفضل ممارسات العمال؟
طورها cloudflare.
هل أفضل ممارسات العمال مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى