skill

أفضل ممارسات العمال

أفضل ممارسات Cloudflare Workers لتطبيقات الإنتاج. تستخدم عند كتابة Workers أو مراجعتها أو تهيئتها.

cloudflare131,317+ تثبيتموثوق

نبذة

قد تكون معرفتك بواجهات برمجة تطبيقات 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل أفضل ممارسات العمال مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل أفضل ممارسات العمال ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط مستندات النطاق. يتم تشغيله مرة واحدة قبل الاستخدام…1,076,003+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى