Index

Properties

bucket

bucket: string

fullPath

fullPath: string

name

name: string

parent

parent: Reference | null

root

root: Reference

storage

storage: Storage

Methods

child

  • child ( path string ) : Reference
  • Parameters

    • path: string

      The relative path from this reference. Leading, trailing, and consecutive slashes are removed.

    Returns Reference

    The reference to the given path.

delete

  • delete ( ) : Promise < void >
  • Returns Promise<void>

    A Promise that resolves if the deletion succeeded and rejects if it failed, including if the object didn't exist.

getDownloadURL

  • getDownloadURL ( ) : Promise < string >
  • Returns Promise<string>

    A Promise that resolves with the download URL or rejects if the fetch failed, including if the object did not exist.

getMetadata

  • getMetadata ( ) : Promise < FullMetadata >
  • Returns Promise<FullMetadata>

    A Promise that resolves with the metadata, or rejects if the fetch failed, including if the object did not exist.

list

  • list ( options ? :  ListOptions ) : Promise < ListResult >
  • List API is only available for Firebase Rules Version 2.

    GCS is a key-blob store. Firebase Storage imposes the semantic of '/' delimited folder structure. Refer to GCS's List API if you want to learn more.

    To adhere to Firebase Rules's Semantics, Firebase Storage does not support objects whose paths end with "/" or contain two consecutive "/"s. Firebase Storage List API will filter these unsupported objects. list() may fail if there are too many unsupported objects in the bucket.

    Parameters

    • Optional options: ListOptions

      See ListOptions for details.

    Returns Promise<ListResult>

    A Promise that resolves with the items and prefixes. prefixes contains references to sub-folders and items contains references to objects in this folder. nextPageToken can be used to get the rest of the results.

listAll

  • listAll ( ) : Promise < ListResult >
  • This is a helper method for calling list() repeatedly until there are no more results. The default pagination size is 1000.

    Note: The results may not be consistent if objects are changed while this operation is running.

    Warning: listAll may potentially consume too many resources if there are too many results.

    Returns Promise<ListResult>

    A Promise that resolves with all the items and prefixes under the current storage reference. prefixes contains references to sub-directories and items contains references to objects in this folder. nextPageToken is never returned.

put

  • put ( data Blob | Uint8Array | ArrayBuffer ,  metadata ? :  UploadMetadata ) : firebase.storage.UploadTask
  • Parameters

    • data: Blob | Uint8Array | ArrayBuffer

      The data to upload.

    • Optional metadata: UploadMetadata

      Metadata for the newly uploaded object.

    Returns firebase.storage.UploadTask

    An object that can be used to monitor and manage the upload.

putString

  • putString ( data string ,  format ? :  StringFormat ,  metadata ? :  UploadMetadata ) : firebase.storage.UploadTask
  • throws

    If the format is not an allowed format, or if the given string doesn't conform to the specified format.

    Parameters

    • data: string

      The string to upload.

    • Optional format: StringFormat

      The format of the string to upload.

    • Optional metadata: UploadMetadata

      Metadata for the newly uploaded object.

    Returns firebase.storage.UploadTask

toString

  • toString ( ) : string
  • Returns string

    The gs:// URL.

updateMetadata

  • updateMetadata ( metadata SettableMetadata ) : Promise < FullMetadata >
  • Parameters

    • metadata: SettableMetadata

      The new metadata. Setting a property to 'null' removes it on the server, while leaving a property as 'undefined' has no effect.

    Returns Promise<FullMetadata>

    A Promise that resolves with the full updated metadata or rejects if the updated failed, including if the object did not exist.