https namespace

関数

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

クラス

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

インターフェース

インターフェース 説明
CallableFunction クライアントが Firebase SDK を使用して呼び出す呼び出し可能メソッドを作成します。
CallableOptions 呼び出し可能な HTTPS 関数で設定できるオプション。
CallableRequest 呼び出し可能関数の呼び出しに使用されるリクエスト。
HttpsOptions onRequest HTTPS 関数で設定できるオプション。
リクエスト リクエスト本文の送信形式で表現されたエクスプレス リクエスト。

型エイリアス

型エイリアス 説明
FunctionsErrorCode Firebase Functions のステータス コードのセット。これらのコードは、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 この関数に設定するオプション。
handler (リクエスト: 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>;

パラメータ

パラメータ 説明
handler (リクエスト: 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 この関数で設定するオプション
handler (リクエスト: リクエスト、レスポンス: express.Response)=>void |約束 <void> Express アプリと同じ署名である https.Request とレスポンス オブジェクトを受け取る関数。

戻り値:

HttpsFunction

エクスポートしてデプロイできる関数。

https.onRequest()

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

署名:

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

パラメータ

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

戻り値:

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

https.HttpsFunction

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

署名:

export type HttpsFunction = ((
req: Request, 
res: express.Response) => void | Promise<void>) & {
    __trigger?: unknown;
    __endpoint: ManifestEndpoint;
};