react-native-firebase/lib/modules/storage/reference.js

107 lines
2.9 KiB
JavaScript
Raw Normal View History

/**
* @flow
* StorageReference representation wrapper
*/
import ReferenceBase from '../../utils/ReferenceBase';
2017-02-14 11:31:42 +00:00
import StorageTask, { UPLOAD_TASK, DOWNLOAD_TASK } from './task';
import { getNativeModule } from '../../utils/native';
import type Storage from './';
2017-02-14 11:31:42 +00:00
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference
*/
export default class StorageReference extends ReferenceBase {
_storage: Storage;
2017-02-14 11:31:42 +00:00
constructor(storage: Storage, path: string) {
super(path);
this._storage = storage;
2017-02-14 11:31:42 +00:00
}
get fullPath(): string {
2017-02-14 11:31:42 +00:00
return this.path;
}
toString(): string {
return `gs://${this._storage.app.options.storageBucket}${this.path}`;
2017-02-14 11:31:42 +00:00
}
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference#child
* @param path
* @returns {StorageReference}
*/
child(path: string): StorageReference {
return new StorageReference(this._storage, `${this.path}/${path}`);
2017-02-14 11:31:42 +00:00
}
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference#delete
* @returns {Promise.<T>|*}
*/
delete(): Promise<void> {
return getNativeModule(this._storage).delete(this.path);
2017-02-14 11:31:42 +00:00
}
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference#getDownloadURL
* @returns {Promise.<T>|*}
*/
getDownloadURL(): Promise<string> {
return getNativeModule(this._storage).getDownloadURL(this.path);
2017-02-14 11:31:42 +00:00
}
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference#getMetadata
* @returns {Promise.<T>|*}
*/
getMetadata(): Promise<Object> {
return getNativeModule(this._storage).getMetadata(this.path);
2017-02-14 11:31:42 +00:00
}
/**
* @url https://firebase.google.com/docs/reference/js/firebase.storage.Reference#updateMetadata
* @param metadata
* @returns {Promise.<T>|*}
*/
updateMetadata(metadata: Object = {}): Promise<Object> {
return getNativeModule(this._storage).updateMetadata(this.path, metadata);
2017-02-14 11:31:42 +00:00
}
/**
* Downloads a reference to the device
* @param {String} filePath Where to store the file
* @return {Promise}
*/
downloadFile(filePath: string): Promise<Object> {
2018-01-25 18:25:39 +00:00
return new StorageTask(
DOWNLOAD_TASK,
getNativeModule(this._storage).downloadFile(this.path, filePath),
this
);
2017-02-14 11:31:42 +00:00
}
/**
* Alias to putFile
* @returns {StorageReference.putFile}
*/
get put(): (Object, Object) => Promise<Object> {
return this.putFile;
}
2017-02-14 11:31:42 +00:00
/**
* Upload a file path
* @param {string} filePath The local path of the file
* @param {object} metadata An object containing metadata
* @return {Promise}
*/
putFile(filePath: Object, metadata: Object = {}): Promise<Object> {
const _filePath = filePath.replace('file://', '');
2018-01-25 18:25:39 +00:00
return new StorageTask(
UPLOAD_TASK,
getNativeModule(this._storage).putFile(this.path, _filePath, metadata),
this
);
2017-02-14 11:31:42 +00:00
}
}