https namespace

ฟังก์ชัน

ฟังก์ชัน คำอธิบาย
onCall(แฮนเดิล) ประกาศเมธอดที่เรียกใช้ได้เพื่อให้ลูกค้าเรียกใช้ได้โดยใช้ Firebase SDK
onRequest(แฮนเดิล) จัดการคำขอ HTTP

ชั้นเรียน

ชั้น คำอธิบาย
HttpsError ข้อผิดพลาดที่ชัดเจนอาจเกิดจากตัวแฮนเดิลเพื่อส่งข้อผิดพลาดไปยังไคลเอ็นต์ที่เรียกใช้ฟังก์ชัน

อินเทอร์เฟซ

อินเทอร์เฟซ คำอธิบาย
CallableContext อินเทอร์เฟซสำหรับข้อมูลเมตาสำหรับ API ที่ส่งไปยังตัวแฮนเดิล
คำขอ คำขอด่วนที่มีรูปแบบการสื่อสารของเนื้อหาคำขอ

พิมพ์ชื่อแทน

พิมพ์ชื่อแทน คำอธิบาย
FunctionsErrorCode ชุดรหัสสถานะฟังก์ชัน Firebase รหัสจะเหมือนกันกับรหัสที่ gRPC เห็น

https.onCall()

ประกาศเมธอดที่เรียกใช้ได้เพื่อให้ลูกค้าเรียกใช้ได้โดยใช้ Firebase SDK

ลายเซ็น:

export declare function onCall(handler: (data: any, context: CallableContext) => any | Promise<any>): HttpsFunction & Runnable<any>;

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ตัวแฮนเดิล (ข้อมูล: ใดก็ได้, บริบท: CallableContext) => ทั้งหมด | สัญญา<ไม่จำกัด> วิธีการที่รับข้อมูลและบริบทและแสดงผลค่า

การคืนสินค้า:

HttpsFunction และ เรียกใช้ได้<ใดก็ได้>

https.onRequest()

จัดการคำขอ HTTP

ลายเซ็น:

export declare function onRequest(handler: (req: Request, resp: express.Response) => void | Promise<void>): HttpsFunction;

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ตัวแฮนเดิล (req: คำขอ, ตอบกลับ: express.Response) => เป็นโมฆะ | คำสัญญา<โมฆะ> ฟังก์ชันที่รับออบเจ็กต์คำขอและออบเจ็กต์การตอบกลับ ซึ่งเป็นลายเซ็นเดียวกับแอป Express

การคืนสินค้า:

HttpsFunction

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: ไม่พร้อมให้บริการในขณะนี้ ปัญหานี้อาจเกิดขึ้นชั่วคราวและอาจแก้ไขได้โดยการลองอีกครั้งโดยใช้ Backoff

  • 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";