Firebase 用クラウド ストレージ
機能
関数 | 説明 |
---|---|
関数(アプリ、...) | |
getStorage(アプリ、バケットUrl) | 指定された Firebase アプリのFirebaseStorageインスタンスを取得します。 |
機能(ストレージ、...) | |
connectStorageEmulator(ストレージ、ホスト、ポート、オプション) | Cloud Storage エミュレータと通信できるように、このFirebaseStorageインスタンスを変更します。 |
ref(ストレージ、URL) | 指定された URL のStorageReferenceを返します。 |
関数(ref, ...) | |
削除オブジェクト(参照) | この場所にあるオブジェクトを削除します。 |
getBlob(ref, maxDownloadSizeBytes) | オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラーを返します。この機能を使用するには、Cloud Storage バケット内のアプリのオリジンをホワイトリストに登録する必要があります。 https://cloud.google.com/storage/docs/cconfiguring-cors も参照してください。この API は Node では使用できません。 |
getBytes(ref, maxDownloadSizeBytes) | オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラーを返します。この機能を使用するには、Cloud Storage バケット内のアプリのオリジンをホワイトリストに登録する必要があります。 https://cloud.google.com/storage/docs/cconfiguring-cors も参照してください。 |
getDownloadURL(参照) | 指定されたStorageReferenceのダウンロード URL を返します。 。 |
getメタデータ(参照) | このオブジェクトのメタデータを使用して解決されるPromise 。このオブジェクトが存在しない場合、またはメタデータを取得できない場合、Promise は拒否されます。 |
getStream(ref, maxDownloadSizeBytes) | オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラー イベントを発生させます。この API は Node.js でのみ使用できます。 |
list(参照、オプション) | このストレージ参照の下の項目 (ファイル) とプレフィックス (フォルダー) をリストします。 List API は Firebase ルール バージョン 2 でのみ使用できます。 GCS はキーブロブ ストアです。 Firebase Storage は、「/」で区切られたフォルダー構造のセマンティクスを強制します。詳細については、GCS の List API を参照してください。 Firebase ルールのセマンティクスに準拠するため、Firebase Storage は、パスが「/」で終わるオブジェクト、または 2 つの連続する「/」を含むオブジェクトをサポートしません。 Firebase Storage List API は、これらのサポートされていないオブジェクトをフィルタリングします。バケット内にサポートされていないオブジェクトが多すぎると、list() が失敗する可能性があります。 |
リストすべて(参照) | このストレージ参照の下にあるすべてのアイテム (ファイル) とプレフィックス (フォルダー) をリストします。これは、結果がなくなるまで list() を繰り返し呼び出すためのヘルパー メソッドです。デフォルトのページネーション サイズは 1000 です。注: この操作の実行中にオブジェクトが変更された場合、結果は一貫性がなくなる可能性があります。警告: listAll 結果が多すぎる場合、リソースを消費しすぎる可能性があります。 |
updateMetadata(ref, メタデータ) | このオブジェクトのメタデータを更新します。 |
UploadBytes(参照、データ、メタデータ) | このオブジェクトの場所にデータをアップロードします。アップロードは再開できません。 |
UploadBytesResumable(参照、データ、メタデータ) | このオブジェクトの場所にデータをアップロードします。アップロードは一時停止および再開でき、進行状況の更新が公開されます。 |
UploadString(参照、値、形式、メタデータ) | このオブジェクトの場所に文字列をアップロードします。アップロードは再開できません。 |
関数(ストレージまたは参照, ...) | |
ref(ストレージまたは参照、パス) | デフォルトのバケット内の指定されたパスのStorageReferenceを返します。 |
クラス
クラス | 説明 |
---|---|
ストレージエラー | Firebase Storage SDK によって返されたエラー。 |
列挙
列挙 | 説明 |
---|---|
ストレージエラーコード | StorageError オブジェクトに付加できるエラー コード。 |
インターフェース
インターフェース | 説明 |
---|---|
Firebaseストレージ | Firebase ストレージ インスタンス。 |
フルメタデータ | 読み取り専用プロパティを含む、オブジェクト メタデータの完全なセット。 |
リストオプション | list() オプションは受け入れます。 |
リスト結果 | list() によって返される結果。 |
設定可能なメタデータ | いつでも設定できるオブジェクトのメタデータ。 |
ストレージオブザーバー | Firebase Storage のストリーム オブザーバー。 |
ストレージリファレンス | Google Cloud Storage オブジェクトへの参照を表します。開発者は、オブジェクトのアップロード、ダウンロード、削除に加えて、オブジェクトのメタデータを取得/設定できます。 |
メタデータのアップロード | アップロード時に設定できるオブジェクトのメタデータ。 |
アップロード結果 | 再開不可能なアップロードから返された結果。 |
アップロードタスク | オブジェクトをアップロードするプロセスを表します。アップロードを監視および管理できます。 |
タスクスナップショットのアップロード | アップロードタスクの現在の状態に関するデータを保持します。 |
変数
変数 | 説明 |
---|---|
文字列形式 | アップロードに使用できる文字列形式の列挙。 |
タイプエイリアス
タイプエイリアス | 説明 |
---|---|
文字列形式 | アップロードに使用できる文字列形式の列挙。 |
タスクイベント | タスクでトリガーされるイベント。 |
タスクの状態 | 実行中のアップロードの現在の状態を表します。 |
関数(アプリ、...)
getStorage(アプリ、バケットUrl)
指定された Firebase アプリのFirebaseStorageインスタンスを取得します。
サイン:
export declare function getStorage(app?: FirebaseApp, bucketUrl?: string): FirebaseStorage;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
アプリ | FirebaseApp | FirebaseStorageインスタンスを取得する Firebase アプリ。 |
バケットURL | 弦 | Firebase ストレージ バケットへの gs:// URL。渡されない場合、アプリのデフォルトのストレージ バケットが使用されます。 |
戻り値:
FirebaseStorageインスタンス。
機能(ストレージ、...)
connectStorageEmulator(ストレージ、ホスト、ポート、オプション)
Cloud Storage エミュレータと通信できるように、このFirebaseStorageインスタンスを変更します。
サイン:
export declare function connectStorageEmulator(storage: FirebaseStorage, host: string, port: number, options?: {
mockUserToken?: EmulatorMockTokenOptions | string;
}): void;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
ストレージ | Firebaseストレージ | FirebaseStorageインスタンス |
ホスト | 弦 | エミュレータホスト (例: localhost) |
ポート | 番号 | エミュレータのポート (例: 5001) |
オプション | {mockUserToken?: EmulatorMockTokenOptions |弦; } | エミュレータのオプション。 options.mockUserToken は、セキュリティ ルールの単体テストに使用する模擬認証トークンです。 |
戻り値:
空所
ref(ストレージ、URL)
指定された URL のStorageReferenceを返します。
サイン:
export declare function ref(storage: FirebaseStorage, url?: string): StorageReference;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
ストレージ | Firebaseストレージ | FirebaseStorageインスタンス。 |
URL | 弦 | URL。空の場合は、ルート参照を返します。 |
戻り値:
関数(ref, ...)
削除オブジェクト(参照)
この場所にあるオブジェクトを削除します。
サイン:
export declare function deleteObject(ref: StorageReference): Promise<void>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | 削除するオブジェクトのStorageReference 。 |
戻り値:
約束<無効>
削除が成功した場合に解決されるPromise
。
getBlob(ref, maxDownloadSizeBytes)
オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラーを返します。
この機能を使用するには、Cloud Storage バケット内のアプリのオリジンをホワイトリストに登録する必要があります。 https://cloud.google.com/storage/docs/cconfiguring-cors も参照してください。
この API は Node では使用できません。
サイン:
export declare function getBlob(ref: StorageReference, maxDownloadSizeBytes?: number): Promise<Blob>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | データをダウンロードする StorageReference。 |
maxDownloadSizeBytes | 番号 | 設定されている場合、取得できる最大許容サイズ (バイト単位)。 |
戻り値:
約束<Blob>
オブジェクトのバイトを含む Blob で解決される Promise
getBytes(ref, maxDownloadSizeBytes)
オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラーを返します。
この機能を使用するには、Cloud Storage バケット内のアプリのオリジンをホワイトリストに登録する必要があります。 https://cloud.google.com/storage/docs/cconfiguring-cors も参照してください。
サイン:
export declare function getBytes(ref: StorageReference, maxDownloadSizeBytes?: number): Promise<ArrayBuffer>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | データをダウンロードする StorageReference。 |
maxDownloadSizeBytes | 番号 | 設定されている場合、取得できる最大許容サイズ (バイト単位)。 |
戻り値:
Promise<ArrayBuffer>
オブジェクトのバイトを含む Promise
getDownloadURL(参照)
指定されたStorageReferenceのダウンロード URL を返します。 。
サイン:
export declare function getDownloadURL(ref: StorageReference): Promise<string>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | ダウンロード URL を取得するStorageReference 。 |
戻り値:
約束<文字列>
このオブジェクトのダウンロード URL で解決されるPromise
。
getメタデータ(参照)
このオブジェクトのメタデータを使用して解決されるPromise
。このオブジェクトが存在しない場合、またはメタデータを取得できない場合、Promise は拒否されます。
サイン:
export declare function getMetadata(ref: StorageReference): Promise<FullMetadata>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | メタデータを取得するStorageReference 。 |
戻り値:
Promise< FullMetadata >
getStream(ref, maxDownloadSizeBytes)
オブジェクトの場所にデータをダウンロードします。オブジェクトが見つからない場合はエラー イベントを発生させます。
この API は Node.js でのみ使用できます。
サイン:
export declare function getStream(ref: StorageReference, maxDownloadSizeBytes?: number): NodeJS.ReadableStream;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | データをダウンロードする StorageReference。 |
maxDownloadSizeBytes | 番号 | 設定されている場合、取得できる最大許容サイズ (バイト単位)。 |
戻り値:
NodeJS.ReadableStream
オブジェクトのデータをバイトとして含むストリーム
list(参照、オプション)
このストレージ参照の下の項目 (ファイル) とプレフィックス (フォルダー) をリストします。
List API は Firebase ルール バージョン 2 でのみ使用できます。
GCS はキーブロブ ストアです。 Firebase Storage は、「/」で区切られたフォルダー構造のセマンティクスを強制します。詳細については、GCS の List API を参照してください。
Firebase ルールのセマンティクスに準拠するため、Firebase Storage は、パスが「/」で終わるオブジェクト、または 2 つの連続する「/」を含むオブジェクトをサポートしません。 Firebase Storage List API は、これらのサポートされていないオブジェクトをフィルタリングします。バケット内にサポートされていないオブジェクトが多すぎると、list() が失敗する可能性があります。
サイン:
export declare function list(ref: StorageReference, options?: ListOptions): Promise<ListResult>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | リストを取得するStorageReference 。 |
オプション | リストオプション | 詳細については、 「ListOptions」を参照してください。 |
戻り値:
Promise< ListResult >
項目と接頭辞で解決されるPromise
。 prefixes
にはサブフォルダーへの参照が含まれ、 items
はこのフォルダー内のオブジェクトへの参照が含まれます。 nextPageToken
使用して残りの結果を取得できます。
リストすべて(参照)
このストレージ参照の下にあるすべてのアイテム (ファイル) とプレフィックス (フォルダー) をリストします。
これは、結果がなくなるまで list() を繰り返し呼び出すためのヘルパー メソッドです。デフォルトのページネーション サイズは 1000 です。
サイン:
export declare function listAll(ref: StorageReference): Promise<ListResult>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | リストを取得するStorageReference 。 |
戻り値:
Promise< ListResult >
現在のストレージ参照にあるすべての項目とプレフィックスで解決されるPromise
。 prefixes
にはサブディレクトリへの参照が含まれ、 items
はこのフォルダー内のオブジェクトへの参照が含まれます。 nextPageToken
は返されません。
updateMetadata(ref, メタデータ)
このオブジェクトのメタデータを更新します。
サイン:
export declare function updateMetadata(ref: StorageReference, metadata: SettableMetadata): Promise<FullMetadata>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | メタデータを更新するStorageReference 。 |
メタデータ | 設定可能なメタデータ | オブジェクトの新しいメタデータ。明示的に設定された値のみが変更されます。値を明示的に null に設定すると、メタデータが削除されます。 |
戻り値:
Promise< FullMetadata >
このオブジェクトの新しいメタデータで解決されるPromise
。
UploadBytes(参照、データ、メタデータ)
このオブジェクトの場所にデータをアップロードします。アップロードは再開できません。
サイン:
export declare function uploadBytes(ref: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): Promise<UploadResult>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | データをアップロードする必要があるStorageReference 。 |
データ | ブロブ | Uint8Array |配列バッファ | アップロードするデータ。 |
メタデータ | メタデータのアップロード | アップロードするデータのメタデータ。 |
戻り値:
Promise< UploadResult >
UploadResult を含む Promise
UploadBytesResumable(参照、データ、メタデータ)
このオブジェクトの場所にデータをアップロードします。アップロードは一時停止および再開でき、進行状況の更新が公開されます。
サイン:
export declare function uploadBytesResumable(ref: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): UploadTask;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | データをアップロードする必要があるStorageReference 。 |
データ | ブロブ | Uint8Array |配列バッファ | アップロードするデータ。 |
メタデータ | メタデータのアップロード | アップロードするデータのメタデータ。 |
戻り値:
アップロードタスク
UploadString(参照、値、形式、メタデータ)
このオブジェクトの場所に文字列をアップロードします。アップロードは再開できません。
サイン:
export declare function uploadString(ref: StorageReference, value: string, format?: StringFormat, metadata?: UploadMetadata): Promise<UploadResult>;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
参照 | ストレージリファレンス | 文字列をアップロードする必要があるStorageReference 。 |
価値 | 弦 | アップロードする文字列。 |
フォーマット | 文字列形式 | アップロードする文字列の形式。 |
メタデータ | メタデータのアップロード | アップロードする文字列のメタデータ。 |
戻り値:
Promise< UploadResult >
UploadResult を含む Promise
関数(ストレージまたは参照, ...)
ref(ストレージまたは参照、パス)
デフォルトのバケット内の指定されたパスのStorageReferenceを返します。
サイン:
export declare function ref(storageOrRef: FirebaseStorage | StorageReference, path?: string): StorageReference;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
ストレージまたは参照 | ファイアベースストレージ|ストレージリファレンス | FirebaseStorageまたはStorageReference 。 |
パス | 弦 |
戻り値:
文字列形式
アップロードに使用できる文字列形式の列挙。
サイン:
StringFormat: {
readonly RAW: "raw";
readonly BASE64: "base64";
readonly BASE64URL: "base64url";
readonly DATA_URL: "data_url";
}
文字列形式
アップロードに使用できる文字列形式の列挙。
サイン:
export declare type StringFormat = (typeof StringFormat)[keyof typeof StringFormat];
タスクイベント
タスクでトリガーされるイベント。
サイン:
export declare type TaskEvent = 'state_changed';
タスクの状態
実行中のアップロードの現在の状態を表します。
サイン:
export declare type TaskState = 'running' | 'paused' | 'success' | 'canceled' | 'error';
ストレージエラーコード
StorageError
オブジェクトに付加できるエラー コード。
サイン:
export declare enum StorageErrorCode
列挙メンバー
メンバー | 価値 | 説明 |
---|---|---|
APP_DELETED | "app-deleted" | |
バケットが見つかりませんでした | "bucket-not-found" | |
キャンセル | "canceled" | |
CANNOT_SLICE_BLOB | "cannot-slice-blob" | |
内部エラー | "internal-error" | |
無効な引数 | "invalid-argument" | |
INVALID_ARGUMENT_COUNT | "invalid-argument-count" | |
INVALID_CHECKSUM | "invalid-checksum" | |
INVALID_DEFAULT_BUCKET | "invalid-default-bucket" | |
INVALID_EVENT_NAME | "invalid-event-name" | |
無効な形式 | "invalid-format" | |
INVALID_ROOT_OPERATION | "invalid-root-operation" | |
無効なURL | "invalid-url" | |
NO_DEFAULT_BUCKET | "no-default-bucket" | |
NO_DOWNLOAD_URL | "no-download-url" | |
OBJECT_NOT_FOUND | "object-not-found" | |
プロジェクト_NOT_FOUND | "project-not-found" | |
割り当て超過 | "quota-exceeded" | |
RETRY_LIMIT_EXCEEDED | "retry-limit-exceeded" | |
SERVER_FILE_WRONG_SIZE | "server-file-wrong-size" | |
未認証 | "unauthenticated" | |
無許可 | "unauthorized" | |
UNAUTHORIZED_APP | "unauthorized-app" | |
未知 | "unknown" | |
UNSUPPORTED_ENVIRONMENT | "unsupported-environment" |