https namespace

関数

関数 説明
onCall(handler) Firebase SDK を使用してクライアントが呼び出す呼び出し可能メソッドを宣言します。
onRequest(handler) HTTP リクエストを処理する。

クラス

クラス 説明
HttpsError 関数を呼び出したクライアントにエラーを送信するためにハンドラからスローされる明示的なエラー。

インターフェース

インターフェース 説明
CallableContext ハンドラに渡される API のメタデータのインターフェース。
リクエスト リクエスト本文の送信形式で表現されたエクスプレス リクエスト。

型エイリアス

型エイリアス 説明
FunctionsErrorCode Firebase Functions のステータス コードのセット。これらのコードは、gRPC によって公開されるコードと同じです。

https.onCall()

Firebase SDK を使用してクライアントが呼び出す呼び出し可能メソッドを宣言します。

署名:

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

パラメータ

パラメータ 説明
handler (data: any, context: CallableContext) =>任意 |<任意> を約束する データとコンテキストを受け取り、値を返すメソッド。

戻り値:

HttpsFunction実行可能<任意>

https.onRequest()

HTTP リクエストを処理する。

署名:

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

パラメータ

パラメータ 説明
handler (リクエスト: リクエスト、レスポンス: express.Response)=>void |約束 <void> Express アプリと同じ署名のリクエスト オブジェクトとレスポンス オブジェクトを受け取る関数。

戻り値:

HttpsFunction

https.FunctionsErrorCode

Firebase Functions のステータス コードのセット。これらのコードは、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";