کارکرد
تابع | شرح |
---|---|
onCall (انتخاب، کنترل کننده) | یک روش فراخوانی را برای مشتریان اعلام می کند تا با استفاده از Firebase SDK تماس بگیرند. |
onCall (کنترل کننده) | یک روش فراخوانی را برای مشتریان اعلام می کند تا با استفاده از Firebase SDK تماس بگیرند. |
onRequest (انتخاب ها، کنترل کننده) | درخواست های HTTPS را رسیدگی می کند. |
onRequest (کنترل کننده) | درخواست های HTTPS را رسیدگی می کند. |
کلاس ها
کلاس | شرح |
---|---|
HttpsError | یک خطای صریح که می تواند از یک کنترل کننده برای ارسال خطایی به کلاینتی که تابع را فراخوانی می کند، پرتاب شود. |
رابط ها
رابط | شرح |
---|---|
CallableFunction | یک روش فراخوانی برای مشتریان ایجاد می کند تا با استفاده از Firebase SDK تماس بگیرند. |
CallableOptions | گزینه هایی که می توانند روی یک تابع HTTPS قابل فراخوانی تنظیم شوند. |
CallableRequest | درخواستی که برای فراخوانی یک تابع قابل فراخوانی استفاده می شود. |
HttpsOptions | گزینه هایی که می توانند روی یک تابع HTTPS onRequest تنظیم شوند. |
درخواست | یک درخواست سریع با فرمت سیمی بدنه درخواست. |
نام مستعار را تایپ کنید
نام مستعار را تایپ کنید | شرح |
---|---|
FunctionsErrorCode | مجموعه کدهای وضعیت توابع Firebase. کدهایی که توسط gRPC در معرض دید قرار می گیرند یکسان هستند . |
HttpsFunction | درخواست های HTTPS را رسیدگی می کند. |
https.onCall()
یک روش فراخوانی را برای مشتریان اعلام می کند تا با استفاده از Firebase SDK تماس بگیرند.
امضا:
export declare function onCall<T = any, Return = any | Promise<any>>(opts: CallableOptions, handler: (request: CallableRequest<T>) => Return): CallableFunction<T, Return>;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
انتخاب می کند | CallableOptions | گزینه هایی برای تنظیم روی این تابع. |
کنترل کننده | (درخواست: CallableRequest <T>) => بازگشت | تابعی که یک https.CallableRequest می گیرد . |
برمی گرداند:
CallableFunction<T, Return>
تابعی که می توانید آن را صادر و اجرا کنید.
https.onCall()
یک روش فراخوانی را برای مشتریان اعلام می کند تا با استفاده از Firebase SDK تماس بگیرند.
امضا:
export declare function onCall<T = any, Return = any | Promise<any>>(handler: (request: CallableRequest<T>) => Return): CallableFunction<T, Return>;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
کنترل کننده | (درخواست: CallableRequest <T>) => بازگشت | تابعی که یک https.CallableRequest می گیرد . |
برمی گرداند:
CallableFunction<T, Return>
تابعی که می توانید آن را صادر و اجرا کنید.
https.onRequest()
درخواست های HTTPS را رسیدگی می کند.
امضا:
export declare function onRequest(opts: HttpsOptions, handler: (request: Request, response: express.Response) => void | Promise<void>): HttpsFunction;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
انتخاب می کند | HttpsOptions | گزینه هایی برای تنظیم روی این تابع |
کنترل کننده | (درخواست: درخواست ، پاسخ: express.Response) => void | قول<باطل> | تابعی که یک شئ https.Request و پاسخ می گیرد، همان امضای یک برنامه Express. |
برمی گرداند:
تابعی که می توانید آن را صادر و اجرا کنید.
https.onRequest()
درخواست های HTTPS را رسیدگی می کند.
امضا:
export declare function onRequest(handler: (request: Request, response: express.Response) => void | Promise<void>): HttpsFunction;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
کنترل کننده | (درخواست: درخواست ، پاسخ: express.Response) => void | قول<باطل> | تابعی که یک شئ https.Request و پاسخ می گیرد، همان امضای یک برنامه Express. |
برمی گرداند:
تابعی که می توانید آن را صادر و اجرا کنید.
https.FunctionsErrorCode
مجموعه کدهای وضعیت توابع Firebase. کدهایی که توسط gRPC در معرض دید قرار می گیرند یکسان هستند .
مقادیر ممکن:
cancelled
: عملیات لغو شد (معمولاً توسط تماس گیرنده).unknown
: خطای ناشناخته یا خطایی از دامنه خطای دیگری.invalid-argument
: کلاینت آرگومان نامعتبری را مشخص کرده است. توجه داشته باشید که این باfailed-precondition
متفاوت است .invalid-argument
آرگومان هایی را نشان می دهد که بدون توجه به وضعیت سیستم مشکل ساز هستند (مثلاً نام فیلد نامعتبر).deadline-exceeded
: مهلت قبل از تکمیل عملیات به پایان رسیده است. برای عملیاتی که وضعیت سیستم را تغییر می دهد، حتی اگر عملیات با موفقیت به پایان رسیده باشد، ممکن است این خطا برگردانده شود. به عنوان مثال، یک پاسخ موفقیتآمیز از یک سرور میتوانست آنقدر به تأخیر بیفتد که مهلت آن به پایان برسد.not-found
: برخی از اسناد درخواستی یافت نشد.already-exists
: برخی از اسنادی که سعی کردیم ایجاد کنیم، از قبل وجود دارد.permission-denied
: تماس گیرنده مجوز اجرای عملیات مشخص شده را ندارد.resource-exhausted
: برخی از منابع تمام شده است، شاید سهمیه هر کاربر، یا شاید کل سیستم فایل خالی است.failed-precondition
: عملیات رد شد زیرا سیستم در وضعیت لازم برای اجرای عملیات نیست.aborted
: این عملیات معمولاً به دلیل یک مسئله همزمانی مانند سقط تراکنش و غیره متوقف شد.out-of-range
: عملیات از محدوده معتبر گذشته است.unimplemented
: عملیات اجرا نمی شود یا پشتیبانی نمی شود/فعال می شود.internal
: خطاهای داخلی به این معنی که برخی از متغیرهای مورد انتظار سیستم زیربنایی شکسته شده است. اگر یکی از این خطاها را مشاهده کردید، چیزی بسیار خراب است.unavailable
: این سرویس در حال حاضر در دسترس نیست. این به احتمال زیاد یک وضعیت گذرا است و ممکن است با تلاش مجدد با عقب نشینی اصلاح شود.data-loss
: از دست دادن یا خرابی داده غیرقابل جبران.unauthenticated
: درخواست دارای اعتبار احراز هویت معتبر برای عملیات نیست.
امضا:
export type FunctionsErrorCode = "ok" | "cancelled" | "unknown" | "invalid-argument" | "deadline-exceeded" | "not-found" | "already-exists" | "permission-denied" | "resource-exhausted" | "failed-precondition" | "aborted" | "out-of-range" | "unimplemented" | "internal" | "unavailable" | "data-loss" | "unauthenticated";
https.HttpsFunction
درخواست های HTTPS را رسیدگی می کند.
امضا:
export type HttpsFunction = ((
req: Request,
res: express.Response) => void | Promise<void>) & {
__trigger?: unknown;
__endpoint: ManifestEndpoint;
};