Edge Functions
اكتب دالة في TypeScript، وانشرها بأمر واحد، واستدعها من تطبيقك باستخدام المفتاح العام.
تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.
وظيفة واحدة، ثلاث طرق لتشغيلها#
وظيفة الحافة هي جزء من كود الخادم الذي يخزنه Aurabase لمشروعك ويعمل عند الطلب. يمكنك تشغيل نفس الوظيفة بثلاث طرق:
- مكالمة: يتصل تطبيقك بـ
aura.functions.invoke('name')أو يرسل طلب HTTP، ويحصل على الإجابة. - مهمة: تقوم بوضع مكالمة في قائمة الانتظار للتشغيل في الخلفية، مع تأخير وإعادة المحاولة تلقائيًا.
- جدول زمني: يقوم إدخال cron بإدراج وظيفة في الأوقات التي تختارها.
هناك نوعان من أوقات التشغيل: Deno (TypeScript أو JavaScript، الافتراضي) و WASM (ثنائي Rust مجمع). يتم تشغيل كل مكالمة في العامل المعزول الخاص بها مع حد للذاكرة ومهلة.
عقد الوظيفة#
الدالة Deno هي ملف واحد يستدعي Deno.serve. يتلقى الطلب الذي وصفته ويعيد Response.
typescript
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
لا يتم استدعاء export default أبدًا. الوظيفة عبارة عن ملف واحد : لا يتم شحن الواردات النسبية، لذا استخدم واردات npm: أو https://esm.sh/.
اعثر على ما تحتاجه#
| أريد أن… | اقرأ |
|---|---|
| نشر واستدعاء وظيفتي الأولى | وظيفة الحافة الأولى |
| اتصل بوظيفة واعرف من المتصل | استدعاء دالة |
| التعامل مع حالات الفشل والمهلات وإعادة المحاولة | الأخطاء والمهلات وإعادة المحاولة |
| إرجاع نص أو صورة أو HTML | إرجاع النص والثنائي وHTML |
| إعطاء وظيفة مفتاح API | الأسرار ومتغيرات البيئة |
| قم بتشغيل العمل في الخلفية أو وفقًا لجدول زمني | الوظائف والكرون وقائمة انتظار الحروف الميتة |
| كن حذرًا عندما يحدث خطأ ما | التنبيهات |
| الاختبار محليًا والنشر من CI | الاختبار والنشر من CI |
| ابحث عن أمر | وظائف الهالة وأسرار الهالة |
| ابحث عن الطريق | مرجع HTTP API |
| ابحث عن طريقة SDK | JavaScript SDK: الوظائف |
| معرفة الأحجام والمدد والحصص | الحدود والحصص |
| فهم ما يحدث أثناء المكالمة | كيف يعمل الاستدعاء |
| فهم من يستطيع أن يفعل ماذا | نموذج الأمان |
| انتقل إلى SDK 0.6 | الترقية إلى SDK 0.6 |
حقائق يجب معرفتها أولا#
- فقط استدعاء تعمل الوظيفة مع المفتاح العام. كل شيء آخر يحتاج إلى مفتاح
service_roleوينتمي إلى الخادم الخاص بك. - يجب أن تظل الطلبات والردود أقل من حوالي 256 كيلو بايت. استخدم التخزين للبيانات الأكبر.
- كل مكالمة عديمة الجنسية. لا تحتفظ بالبيانات في الذاكرة بين المكالمات.
- الأسرار هي متغيرات الدالة، معدة بـ
aura secrets setأوPUT /env. ينطبق التشفير في حالة عدم النشاط فقط على المسارPUTوفقط عندما يكون للنشر مفتاح. - ما تكتبه الوظيفة بـ
console.logليس متاحًا لك بعد. راجع حدود Limits and quotas لمعرفة الفجوات الحالية. - توجد منطقة واحدة ولا يوجد سجل للإصدارات: احتفظ بوظائفك في Git.