الأخطاء والمهلات وإعادة المحاولة

invoke يُرجع { data, error } ولا يُرمي أبدًا. error هو AuraError، لذا فإن isAuraError(error) صحيح. تخبرك فئتان فرعيتان بمن فشل:

import { FunctionsHttpError, FunctionsRelayError } from '@aurabase/aurabase-js'

const { data, error } = await aura.functions.invoke('checkout', { body })

if (error instanceof FunctionsHttpError) {
  // تم الرد على وظيفتك بحالة خطأ. تصحيح التعليمات البرمجية الخاصة بك.
} else if (error instanceof FunctionsRelayError) {
  // فشل النظام الأساسي: لم تعد إجابة وظيفتك أبدًا.
} else if (error) {
  // تم إلغاء المكالمة أو رفضها على العميل (مهلة، valid_body، no_session).
}

السلوكيات التي تمت ملاحظتها ضد المكدس قيد التشغيل. يتبع صف الحصص تعيين الأخطاء في الواجهة الخلفية ولم يتم تشغيله في اختباراتنا.

لا يقوم SDK أبدًا بإعادة محاولة استدعاء لك: قد يكون لوظيفتك آثار جانبية، وPOST المتكرر ليس آمنًا بشكل افتراضي. عليك أن تقرر، باستخدام الجدول أدناه.

import { FunctionsRelayError } from '@aurabase/aurabase-js'

async function invokeWithRetry(name: string, body: unknown, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await aura.functions.invoke(name, { body })
    const safe = res.error instanceof FunctionsRelayError && res.error.status === 503
    if (!res.error || !safe) return res
    await new Promise((r) => setTimeout(r, 2 ** i * 500))
  }
  return aura.functions.invoke(name, { body })
}

ثلاث ساعات تعمل في وقت واحد:

عندما تتجاوز الدالة timeout_secs، فإن وقت التشغيل يلغيها وتفشل مكالمتك بعد هذا التأخير تقريبًا، مع 500 أو 503 الموضح أعلاه. يظهر السبب في error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) في الوضع الأولي. قم بتعيين عميلك timeout أعلى قليلاً من timeout_secs الخاص بالوظيفة لرؤية هذا الخطأ بدلاً من العميل timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // تم الإلغاء من قبل عميلك. ربما لا تزال الوظيفة قيد التشغيل.
}

للعمل لمدة أطول من بضع ثوانٍ، قم بوضع في قائمة الانتظار لمهمة بدلاً من إبقاء الاتصال مفتوحًا.

• تحمل أخطاء النظام الأساسي معرف الطلب: error.details.error.request_id. اقتبسها عند الاتصال بالدعم.
• يسرد aura functions logs <name> طلبات HTTP الأخيرة مع الطريقة والمسار والحالة والمدة ومعرف الطلب. إنه لا يعرض ما كتبته وظيفتك باستخدام console.log أو console.error: يبقى هذا الإخراج في سجلات وقت التشغيل الخاصة، والتي لا يمكن قراءتها إلا لمشغل النظام الأساسي. راجع حدود للتعرف على هذا والفجوات الحالية الأخرى.
• لا يتم إعادة توجيه معرف المكالمة إلى وظيفتك. قم بتمرير المعرف الخاص بك إلى headers وقم بتسجيله.