เรียกใช้ฟังก์ชันจากแอปของคุณ


Cloud Functions for Firebase SDK ของไคลเอ็นต์ช่วยให้คุณเรียกใช้ฟังก์ชันได้โดยตรงจาก แอป Firebase หากต้องการเรียกใช้ฟังก์ชันจากแอปด้วยวิธีนี้ ให้เขียนและติดตั้งใช้งาน ฟังก์ชันที่เรียกใช้ได้ผ่าน HTTP ใน Cloud Functions แล้ว เพิ่มตรรกะของไคลเอ็นต์เพื่อเรียกใช้ฟังก์ชันจากแอป

โปรดทราบว่าฟังก์ชันที่เรียกใช้ HTTP ได้จะคล้ายกับฟังก์ชัน HTTP แต่ไม่เหมือนกัน หากต้องการใช้ฟังก์ชันที่เรียกใช้ได้ผ่าน HTTP คุณต้องใช้ SDK ของไคลเอ็นต์สำหรับแพลตฟอร์มของคุณร่วมกับ API แบ็กเอนด์ (หรือใช้โปรโตคอล) ฟังก์ชันที่เรียกใช้ได้มีความแตกต่างที่สำคัญจากฟังก์ชัน HTTP ดังนี้

  • เมื่อมีให้ใช้งาน ระบบจะรวมโทเค็น Firebase Authentication, FCM และ App Check ไว้ในคำขอโดยอัตโนมัติ
  • ทริกเกอร์จะยกเลิกการซีเรียลไลซ์ส่วนเนื้อหาของคำขอและตรวจสอบโทเค็นการให้สิทธิ์โดยอัตโนมัติ

Firebase SDK สำหรับ Cloud Functions รุ่นที่ 2 ขึ้นไปจะทำงานร่วมกับ Firebase Client SDK เวอร์ชันขั้นต่ำต่อไปนี้เพื่อรองรับฟังก์ชันที่เรียกใช้ได้ผ่าน HTTPS

  • Firebase SDK สำหรับแพลตฟอร์ม Apple 11.15.0
  • Firebase SDK สำหรับ Android 21.2.1
  • Firebase Modular Web SDK v. 9.7.0

หากต้องการเพิ่มฟังก์ชันที่คล้ายกันลงในแอปที่สร้างบนแพลตฟอร์มที่ไม่รองรับ โปรดดูข้อกำหนดโปรโตคอลสำหรับ https.onCall ส่วนที่เหลือของคู่มือนี้จะให้ วิธีการเขียน การติดตั้งใช้งาน และการเรียกใช้ ฟังก์ชันที่เรียกใช้ได้ผ่าน HTTP สำหรับแพลตฟอร์ม Apple, Android, เว็บ, C++ และ Unity

เขียนและติดตั้งใช้งานฟังก์ชันที่เรียกใช้ได้

ใช้ functions.https.onCall เพื่อสร้างฟังก์ชันที่เรียกใช้ได้ผ่าน HTTPS เมธอดนี้ ใช้พารามิเตอร์ 2 ตัว ได้แก่ data และ context (ไม่บังคับ) ดังนี้

  // Saves a message to the Firebase Realtime Database but sanitizes the
  // text by removing swearwords.
  exports.addMessage = functions.https.onCall((data, context) => {
    // ...
  });

สำหรับฟังก์ชันที่เรียกใช้ได้ซึ่งบันทึกข้อความไปยัง Realtime Database เช่น data อาจมีข้อความ ขณะที่พารามิเตอร์ context แสดงข้อมูลการให้สิทธิ์ของผู้ใช้

// Message text passed from the client.
const text = request.data.text;
// Authentication / user information is automatically added to the request.
const uid = request.auth.uid;
const name = request.auth.token.name || null;
const picture = request.auth.token.picture || null;
const email = request.auth.token.email || null;
index.js

ระยะห่างระหว่างตำแหน่งของฟังก์ชันที่เรียกใช้ได้กับตำแหน่งของไคลเอ็นต์ที่เรียกใช้จะทำให้เกิดเวลาในการตอบสนองของเครือข่าย หากต้องการเพิ่มประสิทธิภาพ ให้พิจารณาระบุตำแหน่งฟังก์ชันในกรณีที่เกี่ยวข้อง และตรวจสอบว่าตำแหน่งของฟังก์ชันที่เรียกใช้ได้สอดคล้องกับตำแหน่งที่ตั้งค่าไว้เมื่อเริ่มต้น SDK ในฝั่งไคลเอ็นต์

คุณแนบApp Checkการรับรองเพื่อช่วยปกป้องทรัพยากรแบ็กเอนด์จากการละเมิด เช่น การฉ้อโกงผ่านการเรียกเก็บเงินหรือฟิชชิง ได้ (ไม่บังคับ) ดูเปิดใช้การบังคับใช้ App Check สำหรับ Cloud Functions

ใช้งานได้

การส่งผลลัพธ์กลับ

หากต้องการส่งข้อมูลกลับไปยังไคลเอ็นต์ ให้ส่งข้อมูลที่เข้ารหัส JSON ได้ เช่น หากต้องการแสดงผลลัพธ์ของการดำเนินการบวก ให้ทำดังนี้

// returning result.
return {
  firstNumber: firstNumber,
  secondNumber: secondNumber,
  operator: "+",
  operationResult: firstNumber + secondNumber,
};
index.js

หากต้องการแสดงผลข้อมูลหลังจากการดำเนินการแบบอะซิงโครนัส ให้แสดงผล Promise ระบบจะส่งข้อมูล ที่สัญญาแสดงผลกลับไปยังไคลเอ็นต์ เช่น คุณ อาจแสดงผลข้อความที่ผ่านการล้างข้อมูลซึ่งฟังก์ชันที่เรียกใช้ได้เขียนไปยัง Realtime Database:

// Saving the new message to the Realtime Database.
const sanitizedMessage = sanitizer.sanitizeText(text); // Sanitize message.

return getDatabase().ref("/messages").push({
  text: sanitizedMessage,
  author: {uid, name, picture, email},
}).then(() => {
  logger.info("New Message written");
  // Returning the sanitized message to the client.
  return {text: sanitizedMessage};
})
index.js

จัดการข้อผิดพลาด

หากต้องการให้ไคลเอ็นต์ได้รับรายละเอียดข้อผิดพลาดที่เป็นประโยชน์ ให้ส่งข้อผิดพลาดจากฟังก์ชันที่เรียกใช้ได้ โดยการส่ง (หรือส่งคืน Promise ที่ถูกปฏิเสธด้วย) อินสแตนซ์ของ functions.https.HttpsError ข้อผิดพลาดมีแอตทริบิวต์ code ซึ่งอาจเป็นค่าใดค่าหนึ่งที่ระบุไว้ ที่ functions.https.HttpsError ข้อผิดพลาดยังมีสตริง message ซึ่งค่าเริ่มต้น จะเป็นสตริงว่าง นอกจากนี้ ยังมีdetailsฟิลด์ที่ไม่บังคับซึ่งมีค่า โดยพลการได้ด้วย หากฟังก์ชันแสดงข้อผิดพลาดอื่นนอกเหนือจาก HttpsError ไคลเอ็นต์จะได้รับข้อผิดพลาดพร้อมข้อความ INTERNAL และรหัส internal แทน

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

// Checking attribute.
if (!(typeof text === "string") || text.length === 0) {
  // Throwing an HttpsError so that the client gets the error details.
  throw new HttpsError("invalid-argument", "The function must be called " +
          "with one arguments \"text\" containing the message text to add.");
}
// Checking that the user is authenticated.
if (!request.auth) {
  // Throwing an HttpsError so that the client gets the error details.
  throw new HttpsError("failed-precondition", "The function must be " +
          "called while authenticated.");
}
index.js

ทําให้ฟังก์ชันที่เรียกใช้ได้ใช้งานได้

หลังจากบันทึกฟังก์ชันที่เรียกใช้ได้ที่เสร็จสมบูรณ์แล้วภายใน index.js ระบบจะ นําไปใช้งานพร้อมกับฟังก์ชันอื่นๆ ทั้งหมดเมื่อคุณเรียกใช้ firebase deploy หากต้องการปรับใช้เฉพาะฟังก์ชันที่เรียกใช้ได้ ให้ใช้--onlyอาร์กิวเมนต์ตามที่แสดงเพื่อปรับใช้บางส่วน

firebase deploy --only functions:addMessage

หากพบข้อผิดพลาดเกี่ยวกับสิทธิ์เมื่อติดตั้งใช้งานฟังก์ชัน โปรดตรวจสอบว่าได้กำหนดบทบาท IAM ที่เหมาะสมให้กับผู้ใช้ที่เรียกใช้คำสั่งการติดตั้งใช้งานแล้ว

ตั้งค่าสภาพแวดล้อมในการพัฒนาไคลเอ็นต์

ตรวจสอบว่าคุณมีข้อกำหนดเบื้องต้นทั้งหมด จากนั้นเพิ่มการอ้างอิงและ ไลบรารีไคลเอ็นต์ที่จำเป็นลงในแอป

iOS+

ทำตามวิธีการเพื่อเพิ่ม Firebase ลงในแอป Apple

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase

  1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่File > Add Packages
  2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Apple ของ Firebase ดังนี้
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. เลือกCloud Functions คลัง
  4. เพิ่มแฟล็ก -ObjC ลงในส่วนแฟล็ก Linker อื่นๆ ของการตั้งค่าบิลด์ของเป้าหมาย
  5. เมื่อเสร็จแล้ว Xcode จะเริ่มจับคู่ข้อมูลและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

Web

  1. ทำตามวิธีการเพื่อเพิ่ม Firebase ลงในเว็บแอป อย่าลืมเรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล 
    npm install firebase@11.10.0 --save

  2. ต้องกำหนดทั้ง Firebase Core และ Cloud Functions ด้วยตนเอง

     import { initializeApp } from 'firebase/app';
 import { getFunctions } from 'firebase/functions';

 const app = initializeApp({
     projectId: '### CLOUD FUNCTIONS PROJECT ID ###',
     apiKey: '### FIREBASE API KEY ###',
     authDomain: '### FIREBASE AUTH DOMAIN ###',
   });
 const functions = getFunctions(app);

Web

  1. ทำตามวิธีการเพื่อเพิ่ม Firebase ลงในเว็บแอป
  2. เพิ่มไลบรารีหลักและไลบรารีไคลเอ็นต์ของ Firebase ลงในแอปโดยทำดังนี้ Cloud Functions 
    <script src="https://www.gstatic.com/firebasejs/8.10.1/firebase.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.10.1/firebase-functions.js"></script>

Cloud Functions SDK ยังมีให้บริการเป็นแพ็กเกจ npm ด้วย

  1. เรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล 
    npm install firebase@8.10.1 --save
  2. ต้องกำหนดทั้ง Firebase Core และ Cloud Functions ด้วยตนเอง 
    const firebase = require("firebase");
// Required for side-effects
require("firebase/functions");

Kotlin

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในแอป Android

  2. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Cloud Functions สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการควบคุมเวอร์ชันของไลบรารี 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

    // Add the dependency for the Cloud Functions library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-functions")
}

    การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

    (ทางเลือก)  เพิ่มการอ้างอิงไลบรารี Firebase โดยไม่ใช้ BoM

    หากเลือกไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันของไลบรารี Firebase แต่ละรายการ ในบรรทัดการอ้างอิง

    โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลายรายการในแอป เราขอแนะนำเป็นอย่างยิ่ง ให้ใช้ BoM เพื่อจัดการเวอร์ชันของไลบรารี ซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะ เข้ากันได้ 

    dependencies {
    // Add the dependency for the Cloud Functions library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-functions:21.2.1")
}
         หากกำลังมองหาโมดูลไลบรารีเฉพาะของ Kotlin ตั้งแต่เดือน ตุลาคม 2023 (Firebase BoM 32.5.0) เป็นต้นไป นักพัฒนาแอปทั้ง Kotlin และ Java จะ ขึ้นอยู่กับโมดูลไลบรารีหลักได้ (ดูรายละเอียดได้ที่ คำถามที่พบบ่อยเกี่ยวกับโครงการนี้)

Java

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในแอป Android

  2. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Cloud Functions สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการควบคุมเวอร์ชันของไลบรารี 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

    // Add the dependency for the Cloud Functions library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-functions")
}

    การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

    (ทางเลือก)  เพิ่มการอ้างอิงไลบรารี Firebase โดยไม่ใช้ BoM

    หากเลือกไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันของไลบรารี Firebase แต่ละรายการ ในบรรทัดการอ้างอิง

    โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลายรายการในแอป เราขอแนะนำเป็นอย่างยิ่ง ให้ใช้ BoM เพื่อจัดการเวอร์ชันของไลบรารี ซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะ เข้ากันได้ 

    dependencies {
    // Add the dependency for the Cloud Functions library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-functions:21.2.1")
}
         หากกำลังมองหาโมดูลไลบรารีเฉพาะของ Kotlin ตั้งแต่เดือน ตุลาคม 2023 (Firebase BoM 32.5.0) เป็นต้นไป นักพัฒนาแอปทั้ง Kotlin และ Java จะ ขึ้นอยู่กับโมดูลไลบรารีหลักได้ (ดูรายละเอียดได้ที่ คำถามที่พบบ่อยเกี่ยวกับโครงการนี้)

Dart

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในแอป Flutter

  2. จากรูทของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อ ติดตั้งปลั๊กอิน

    flutter pub add cloud_functions

  3. เมื่อเสร็จแล้ว ให้สร้างแอปพลิเคชัน Flutter ใหม่โดยทำดังนี้

    flutter run

  4. เมื่อติดตั้งแล้ว คุณจะเข้าถึงcloud_functions ปลั๊กอินได้โดยการนำเข้าในโค้ด Dart ดังนี้

    import 'package:cloud_functions/cloud_functions.dart';

C++

สำหรับ C++ ที่ใช้กับ Android ให้ทำดังนี้

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในโปรเจ็กต์ C++
  2. เพิ่มไลบรารี firebase_functions ลงในไฟล์ CMakeLists.txt

สำหรับ C++ ที่ใช้กับแพลตฟอร์มของ Apple

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในโปรเจ็กต์ C++
  2. เพิ่มพ็อด Cloud Functions ลงใน Podfile โดยทำดังนี้ 
    pod 'Firebase/Functions'
  3. บันทึกไฟล์ แล้วเรียกใช้คำสั่งต่อไปนี้ 
    pod install
  4. เพิ่มเฟรมเวิร์กหลักของ Firebase และ Cloud Functions จาก Firebase C++ SDK ลงในโปรเจ็กต์ Xcode
    • firebase.framework
    • firebase_functions.framework

Unity

  1. ทําตามวิธีการเพื่อเพิ่ม Firebase ลงในโปรเจ็กต์ Unity
  2. เพิ่ม FirebaseFunctions.unitypackage จาก Firebase Unity SDK ลงในโปรเจ็กต์ Unity

เริ่มต้น SDK ของไคลเอ็นต์

เริ่มต้นอินสแตนซ์ของ Cloud Functions

Swift

lazy var functions = Functions.functions()
CloudAddCell.swift

Objective-C

@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functions];
CloudAddCell.m

Web 

firebase.initializeApp({
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
  projectId: '### CLOUD FUNCTIONS PROJECT ID ###'
  databaseURL: 'https://### YOUR DATABASE NAME ###.firebaseio.com',
});

// Initialize Cloud Functions through Firebase
var functions = firebase.functions();

Web 

const app = initializeApp({
  projectId: '### CLOUD FUNCTIONS PROJECT ID ###',
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
});
const functions = getFunctions(app);

Kotlin 

private lateinit var functions: FirebaseFunctions
// ...
functions = Firebase.functions
MainActivity.kt

Java 

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance();
MainActivity.java

Dart 

final functions = FirebaseFunctions.instance;

C++

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance(app);

Unity

functions = Firebase.Functions.DefaultInstance;

เรียกใช้ฟังก์ชัน

Swift

functions.httpsCallable("addMessage").call(["text": inputField.text]) { result, error in
  if let error = error as NSError? {
    if error.domain == FunctionsErrorDomain {
      let code = FunctionsErrorCode(rawValue: error.code)
      let message = error.localizedDescription
      let details = error.userInfo[FunctionsErrorDetailsKey]
    }
    // ...
  }
  if let data = result?.data as? [String: Any], let text = data["text"] as? String {
    self.resultField.text = text
  }
}
CommentCell.swift

Objective-C

[[_functions HTTPSCallableWithName:@"addMessage"] callWithObject:@{@"text": _inputField.text}
                                                      completion:^(FIRHTTPSCallableResult * _Nullable result, NSError * _Nullable error) {
  if (error) {
    if ([error.domain isEqual:@"com.firebase.functions"]) {
      FIRFunctionsErrorCode code = error.code;
      NSString *message = error.localizedDescription;
      NSObject *details = error.userInfo[@"details"];
    }
    // ...
  }
  self->_resultField.text = result.data[@"text"];
}];

Web 

var addMessage = firebase.functions().httpsCallable('addMessage');
addMessage({ text: messageText })
  .then((result) => {
    // Read result of the Cloud Function.
    var sanitizedMessage = result.data.text;
  });
callable.js

Web 

import { getFunctions, httpsCallable } from "firebase/functions";

const functions = getFunctions();
const addMessage = httpsCallable(functions, 'addMessage');
addMessage({ text: messageText })
  .then((result) => {
    // Read result of the Cloud Function.
    /** @type {any} */
    const data = result.data;
    const sanitizedMessage = data.text;
  });
fb_functions_call_add_message.js

Kotlin 

private fun addMessage(text: String): Task<String> {
    // Create the arguments to the callable function.
    val data = hashMapOf(
        "text" to text,
        "push" to true,
    )

    return functions
        .getHttpsCallable("addMessage")
        .call(data)
        .continueWith { task ->
            // This continuation runs on either success or failure, but if the task
            // has failed then result will throw an Exception which will be
            // propagated down.
            val result = task.result?.data as String
            result
        }
}
MainActivity.kt

Java 

private Task<String> addMessage(String text) {
    // Create the arguments to the callable function.
    Map<String, Object> data = new HashMap<>();
    data.put("text", text);
    data.put("push", true);

    return mFunctions
            .getHttpsCallable("addMessage")
            .call(data)
            .continueWith(new Continuation<HttpsCallableResult, String>() {
                @Override
                public String then(@NonNull Task<HttpsCallableResult> task) throws Exception {
                    // This continuation runs on either success or failure, but if the task
                    // has failed then getResult() will throw an Exception which will be
                    // propagated down.
                    String result = (String) task.getResult().getData();
                    return result;
                }
            });
}
MainActivity.java

Dart 

    final result = await FirebaseFunctions.instance.httpsCallable('addMessage').call(
      {
        "text": text,
        "push": true,
      },
    );
    _response = result.data as String;

C++

firebase::Future<firebase::functions::HttpsCallableResult> AddMessage(
    const std::string& text) {
  // Create the arguments to the callable function.
  firebase::Variant data = firebase::Variant::EmptyMap();
  data.map()["text"] = firebase::Variant(text);
  data.map()["push"] = true;

  // Call the function and add a callback for the result.
  firebase::functions::HttpsCallableReference doSomething =
      functions->GetHttpsCallable("addMessage");
  return doSomething.Call(data);
}

Unity

private Task<string> addMessage(string text) {
  // Create the arguments to the callable function.
  var data = new Dictionary<string, object>();
  data["text"] = text;
  data["push"] = true;

  // Call the function and extract the operation from the result.
  var function = functions.GetHttpsCallable("addMessage");
  return function.CallAsync(data).ContinueWith((task) => {
    return (string) task.Result.Data;
  });
}

จัดการข้อผิดพลาดในไคลเอ็นต์

ไคลเอ็นต์จะได้รับข้อผิดพลาดหากเซิร์ฟเวอร์แสดงข้อผิดพลาดหรือหาก Promise ที่ได้ถูกปฏิเสธ

หากข้อผิดพลาดที่ฟังก์ชันแสดงผลเป็นประเภท function.https.HttpsError, ไคลเอ็นต์จะได้รับข้อผิดพลาด code, message และ details จาก ข้อผิดพลาดของเซิร์ฟเวอร์ ไม่เช่นนั้น ข้อผิดพลาดจะมีข้อความ INTERNAL และรหัส INTERNAL ดูคำแนะนำเกี่ยวกับวิธี จัดการข้อผิดพลาดในฟังก์ชันที่เรียกใช้ได้

Swift

if let error = error as NSError? {
  if error.domain == FunctionsErrorDomain {
    let code = FunctionsErrorCode(rawValue: error.code)
    let message = error.localizedDescription
    let details = error.userInfo[FunctionsErrorDetailsKey]
  }
  // ...
}
CloudAddCell.swift

Objective-C

if (error) {
  if ([error.domain isEqual:@"com.firebase.functions"]) {
    FIRFunctionsErrorCode code = error.code;
    NSString *message = error.localizedDescription;
    NSObject *details = error.userInfo[@"details"];
  }
  // ...
}
CloudAddCell.m

Web 

var addMessage = firebase.functions().httpsCallable('addMessage');
addMessage({ text: messageText })
  .then((result) => {
    // Read result of the Cloud Function.
    var sanitizedMessage = result.data.text;
  })
  .catch((error) => {
    // Getting the Error details.
    var code = error.code;
    var message = error.message;
    var details = error.details;
    // ...
  });
callable.js

Web 

import { getFunctions, httpsCallable } from "firebase/functions";

const functions = getFunctions();
const addMessage = httpsCallable(functions, 'addMessage');
addMessage({ text: messageText })
  .then((result) => {
    // Read result of the Cloud Function.
    /** @type {any} */
    const data = result.data;
    const sanitizedMessage = data.text;
  })
  .catch((error) => {
    // Getting the Error details.
    const code = error.code;
    const message = error.message;
    const details = error.details;
    // ...
  });
fb_functions_call_add_message_error.js

Kotlin 

addMessage(inputMessage)
    .addOnCompleteListener { task ->
        if (!task.isSuccessful) {
            val e = task.exception
            if (e is FirebaseFunctionsException) {
                val code = e.code
                val details = e.details
            }
        }
    }
MainActivity.kt

Java 

addMessage(inputMessage)
  .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
      if (!task.isSuccessful()) {
        Exception e = task.getException();
        if (e instanceof FirebaseFunctionsException) {
          FirebaseFunctionsException ffe = (FirebaseFunctionsException) e;
          FirebaseFunctionsException.Code code = ffe.getCode();
          Object details = ffe.getDetails();
        }
      }
    }
  });
MainActivity.java

Dart 

try {
  final result =
      await FirebaseFunctions.instance.httpsCallable('addMessage').call();
} on FirebaseFunctionsException catch (error) {
  print(error.code);
  print(error.details);
  print(error.message);
}

C++

void OnAddMessageCallback(
    const firebase::Future<firebase::functions::HttpsCallableResult>& future) {
  if (future.error() != firebase::functions::kErrorNone) {
    // Function error code, will be kErrorInternal if the failure was not
    // handled properly in the function call.
    auto code = static_cast<firebase::functions::Error>(future.error());

    // Display the error in the UI.
    DisplayError(code, future.error_message());
    return;
  }

  const firebase::functions::HttpsCallableResult* result = future.result();
  firebase::Variant data = result->data();
  // This will assert if the result returned from the function wasn't a string.
  std::string message = data.string_value();
  // Display the result in the UI.
  DisplayResult(message);
}

// ...

// ...
  auto future = AddMessage(message);
  future.OnCompletion(OnAddMessageCallback);
  // ...

Unity

 addMessage(text).ContinueWith((task) => {
  if (task.IsFaulted) {
    foreach (var inner in task.Exception.InnerExceptions) {
      if (inner is FunctionsException) {
        var e = (FunctionsException) inner;
        // Function error code, will be INTERNAL if the failure
        // was not handled properly in the function call.
        var code = e.ErrorCode;
        var message = e.ErrorMessage;
      }
    }
  } else {
    string result = task.Result;
  }
});

แนะนำ: ป้องกันการละเมิดด้วย App Check

ก่อนเปิดตัวแอป คุณควรเปิดใช้ App Check เพื่อช่วยให้มั่นใจว่าจะมีเพียงแอปของคุณเท่านั้นที่เข้าถึงปลายทางฟังก์ชันที่เรียกใช้ได้