جديدPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2انظر سجل التغيير →

Edge Functions

رمز الخادم، بجانب بياناتك.

اكتب وظائف Deno، واستدعها من SDK مع وجود أخطاء مكتوبة ومهلات، وقم بتشغيلها عند الطلب، في الخلفية أو وفقًا لجدول زمني.

Deno
وقت التشغيل
3
طرق التشغيل: عند الطلب، الوظيفة، كرون
functions.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.functions.invoke<{ ok: boolean }>(
'hello-world',
{ body: { name: 'Ada' } },
)
if (error) throw error

ما هو مدرج

كل شيء لتشغيل التعليمات البرمجية الخاصة بك. بدون إدارة الخوادم.

وقت التشغيل

وظائف دينو

اكتب معالجات الطلب والاستجابة القياسية باستخدام Deno.serve وTypeScript.

الاحتجاج

استدعاء من SDK

استدعاء دالة بالاسم باستخدام الطريقة والمسار والرؤوس والنص.

التوجيه

المسارات الفرعية داخل الوظيفة

يمكن لوظيفة واحدة أن تخدم عدة مسارات وطرق.

السيطرة

المهلة والإلغاء

قم بتعيين مهلة أو قم بتمرير AbortSignal. كلاهما يبلغان عن نفس خطأ المهلة.

أخطاء

الأخطاء المكتوبة

أخبر عن خطأ تم إرجاعه من خلال فشل الترحيل، حتى تعرف ما إذا كان قد تم تشغيله قبل إعادة المحاولة.

الردود

JSON أو text أو Blob أو ArrayBuffer

اختر كيفية فك تشفير نص الاستجابة.

الخلفية

وظائف غير متزامنة

قائمة الوظائف حسب الحالة واتبع واحدة من خلال معرفها.

الجداول الزمنية

وظائف كرون

قم بتشغيل دالة وفقًا لجدول cron، مع حمولة.

نشر

النشر من واجهة سطر الأوامر (CLI) أو الاستوديو

قم بشحن وظيفة باستخدام aura CLI، من Studio، أو من خلال HTTP API.

كيف يعمل

من المعالج إلى المكالمة.

  1. 1

    اكتب

    قم بإنشاء معالج Deno.serve الذي يقرأ الطلب ويعيد الاستجابة.

  2. 2

    نشر

    قم بشحنه مع نشر وظائف الهالة أو من الاستوديو.

  3. 3

    استدعاء

    أطلق عليها اسمًا باستخدام aura.functions.invoc.

  4. 4

    الجدول الزمني

    قم بتشغيله اختياريًا وفقًا لجدول كرون.

REST API

هل تفضل HTTP العادي؟ كل شيء هنا.

SDK عبارة عن طبقة رقيقة فوق هذه المسارات. أرسل مفتاح API الخاص بمشروعك مع كل طلب.

الطريقةنقطة النهايةالوصف
GET/v1/functionsاذكر وظائف المشروع.
GET/v1/functions/{name}اقرأ تفاصيل وظيفة واحدة.
POST/v1/functions/{name}/invokeقم بتشغيل دالة باستخدام الأسلوب والمسار والرؤوس والنص.
GET/v1/functions/jobsقائمة الوظائف غير المتزامنة، التي تمت تصفيتها حسب الحالة.
GET/v1/functions/jobs/{id}قراءة عمل واحد.
GET/v1/functions/cronقائمة الوظائف المجدولة.
POST/v1/functions/cronجدولة دالة باستخدام تعبير cron.
DELETE/v1/functions/cron/{name}حذف مهمة مجدولة.

أسئلة

من الجيد أن نعرف.

ما وقت التشغيل الذي تستخدمه الوظائف؟+
دينو. وظيفتك عبارة عن معالج Deno.serve مكتوب بلغة TypeScript أو JavaScript.
كيف يمكنني نشر وظيفة؟+
قم بتشغيل وظائف aura ونشر <name> باستخدام واجهة سطر الأوامر (CLI)، أو استخدم Studio أو HTTP API. يستدعي SDK الوظائف ولكنه لا ينشرها.
هل يمكن للوظيفة دفق استجابتها؟+
لا. تنتظر SDK الاستجابة بالكامل قبل أن يتم حلها، أيًا كان نوع الاستجابة الذي تختاره.
هل من الآمن إعادة محاولة مكالمة فاشلة؟+
بعد 503، لم يتم تشغيل الوظيفة، لذا فإن إعادة المحاولة آمنة. بعد 504، بدأت بالفعل وربما كانت لها آثار جانبية، لذا أعد محاولة العمليات غير الفعالة فقط.
هل يمكنني جدولة وظيفة؟+
نعم. قم بإنشاء مهمة cron بالاسم وتعبير cron والوظيفة المراد الاتصال بها. يمكنك سرد وحذف المهام من SDK.
هل يمكنني اختيار المنطقة التي تعمل فيها الوظيفة؟+
ليس في الوقت الراهن. اختيار المنطقة للوظائف غير متاح.

هل أنت مستعد لتشغيل الكود؟

اشحن وظيفتك الأولى اليوم.

يتم تضمين الوظائف في كل مشروع. لا حاجة لبطاقة الائتمان.