انتقل إلى المحتوى
شعار أوراباسي
aurabase

Edge Functions

اكتب دالة في TypeScript، وانشرها بأمر واحد، واستدعها من تطبيقك باستخدام المفتاح العام.

شرح4 د قراءةالمستوى مبتدئتمت المراجعة في 12‏/10‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

وظيفة واحدة، ثلاث طرق لتشغيلها#

وظيفة الحافة هي جزء من كود الخادم الذي يخزنه Aurabase لمشروعك ويعمل عند الطلب. يمكنك تشغيل نفس الوظيفة بثلاث طرق:

  • مكالمة: يتصل تطبيقك بـ aura.functions.invoke('name') أو يرسل طلب HTTP، ويحصل على الإجابة.
  • مهمة: تقوم بوضع مكالمة في قائمة الانتظار للتشغيل في الخلفية، مع تأخير وإعادة المحاولة تلقائيًا.
  • جدول زمني: يقوم إدخال cron بإدراج وظيفة في الأوقات التي تختارها.

هناك نوعان من أوقات التشغيل: Deno (TypeScript أو JavaScript، الافتراضي) و WASM (ثنائي Rust مجمع). يتم تشغيل كل مكالمة في العامل المعزول الخاص بها مع حد للذاكرة ومهلة.

عقد الوظيفة#

الدالة Deno هي ملف واحد يستدعي Deno.serve. يتلقى الطلب الذي وصفته ويعيد Response.

aurabase/functions/hello/index.tstypescript
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
ابحث عن طريقة SDKJavaScript SDK: الوظائف
معرفة الأحجام والمدد والحصصالحدود والحصص
فهم ما يحدث أثناء المكالمةكيف يعمل الاستدعاء
فهم من يستطيع أن يفعل ماذانموذج الأمان
انتقل إلى SDK 0.6الترقية إلى SDK 0.6

حقائق يجب معرفتها أولا#

  • فقط استدعاء تعمل الوظيفة مع المفتاح العام. كل شيء آخر يحتاج إلى مفتاح service_role وينتمي إلى الخادم الخاص بك.
  • يجب أن تظل الطلبات والردود أقل من حوالي 256 كيلو بايت. استخدم التخزين للبيانات الأكبر.
  • كل مكالمة عديمة الجنسية. لا تحتفظ بالبيانات في الذاكرة بين المكالمات.
  • الأسرار هي متغيرات الدالة، معدة بـ aura secrets set أو PUT /env. ينطبق التشفير في حالة عدم النشاط فقط على المسار PUT وفقط عندما يكون للنشر مفتاح.
  • ما تكتبه الوظيفة بـ console.log ليس متاحًا لك بعد. راجع حدود Limits and quotas لمعرفة الفجوات الحالية.
  • توجد منطقة واحدة ولا يوجد سجل للإصدارات: احتفظ بوظائفك في Git.