docs-devsite/storage.storagereference.md
Project: /docs/reference/js/_project.yaml Book: /docs/reference/_book.yaml page_type: reference
{% comment %} DO NOT EDIT THIS FILE! This is generated by the JS SDK team, and any local changes will be overwritten. Changes should be made in the source code at https://github.com/firebase/firebase-js-sdk {% endcomment %}
Represents a reference to a Google Cloud Storage object. Developers can upload, download, and delete objects, as well as get/set object metadata.
<b>Signature:</b>
export interface StorageReference
| Property | Type | Description |
|---|---|---|
| bucket | string | The name of the bucket containing this reference's object. |
| fullPath | string | The full path of this object. |
| name | string | The short name of this object, which is the last component of the full path. For example, if fullPath is 'full/path/image.png', name is 'image.png'. |
| parent | StorageReference | null | A reference pointing to the parent location of this reference, or null if this reference is the root. |
| root | StorageReference | A reference to the root of this object's bucket. |
| storage | FirebaseStorage | The FirebaseStorage instance associated with this reference. |
| Method | Description |
|---|---|
| toString() | Returns a gs:// URL for this object in the form <code>gs://<bucket>/<path>/<to>/<object></code> |
The name of the bucket containing this reference's object.
<b>Signature:</b>
bucket: string;
The full path of this object.
<b>Signature:</b>
fullPath: string;
The short name of this object, which is the last component of the full path. For example, if fullPath is 'full/path/image.png', name is 'image.png'.
<b>Signature:</b>
name: string;
A reference pointing to the parent location of this reference, or null if this reference is the root.
<b>Signature:</b>
parent: StorageReference | null;
A reference to the root of this object's bucket.
<b>Signature:</b>
root: StorageReference;
The FirebaseStorage instance associated with this reference.
<b>Signature:</b>
storage: FirebaseStorage;
Returns a gs:// URL for this object in the form gs://<bucket>/<path>/<to>/<object>
<b>Signature:</b>
toString(): string;
<b>Returns:</b>
string
The gs:// URL.