272 lines
10 KiB
JavaScript
272 lines
10 KiB
JavaScript
"use strict";
|
|
// The MIT License (MIT)
|
|
//
|
|
// Copyright (c) 2022 Firebase
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
// of this software and associated documentation files (the "Software"), to deal
|
|
// in the Software without restriction, including without limitation the rights
|
|
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
// copies of the Software, and to permit persons to whom the Software is
|
|
// furnished to do so, subject to the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be included in all
|
|
// copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
// SOFTWARE.
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.DataSnapshot = void 0;
|
|
const _ = require("lodash");
|
|
const path_1 = require("../../utilities/path");
|
|
/**
|
|
* Interface representing a Firebase Realtime Database data snapshot.
|
|
*/
|
|
class DataSnapshot {
|
|
constructor(data, path, // path will be undefined for the database root
|
|
app, instance) {
|
|
var _a, _b;
|
|
this.app = app;
|
|
if ((_b = (_a = app === null || app === void 0 ? void 0 : app.options) === null || _a === void 0 ? void 0 : _a.databaseURL) === null || _b === void 0 ? void 0 : _b.startsWith('http:')) {
|
|
// In this case we're dealing with an emulator
|
|
this.instance = app.options.databaseURL;
|
|
}
|
|
else if (instance) {
|
|
// SDK always supplies instance, but user's unit tests may not
|
|
this.instance = instance;
|
|
}
|
|
else if (app) {
|
|
this.instance = app.options.databaseURL;
|
|
}
|
|
else if (process.env.GCLOUD_PROJECT) {
|
|
this.instance =
|
|
'https://' + process.env.GCLOUD_PROJECT + '.firebaseio.com';
|
|
}
|
|
this._path = path;
|
|
this._data = data;
|
|
}
|
|
/**
|
|
* Returns a [`Reference`](/docs/reference/admin/node/admin.database.Reference)
|
|
* to the Database location where the triggering write occurred. Has
|
|
* full read and write access.
|
|
*/
|
|
get ref() {
|
|
if (!this.app) {
|
|
// may be unpopulated in user's unit tests
|
|
throw new Error('Please supply a Firebase app in the constructor for DataSnapshot' +
|
|
' in order to use the .ref method.');
|
|
}
|
|
if (!this._ref) {
|
|
this._ref = this.app.database(this.instance).ref(this._fullPath());
|
|
}
|
|
return this._ref;
|
|
}
|
|
/**
|
|
* The key (last part of the path) of the location of this `DataSnapshot`.
|
|
*
|
|
* The last token in a Database location is considered its key. For example,
|
|
* "ada" is the key for the `/users/ada/` node. Accessing the key on any
|
|
* `DataSnapshot` will return the key for the location that generated it.
|
|
* However, accessing the key on the root URL of a Database will return `null`.
|
|
*/
|
|
get key() {
|
|
const last = _.last((0, path_1.pathParts)(this._fullPath()));
|
|
return !last || last === '' ? null : last;
|
|
}
|
|
/**
|
|
* Extracts a JavaScript value from a `DataSnapshot`.
|
|
*
|
|
* Depending on the data in a `DataSnapshot`, the `val()` method may return a
|
|
* scalar type (string, number, or boolean), an array, or an object. It may also
|
|
* return `null`, indicating that the `DataSnapshot` is empty (contains no
|
|
* data).
|
|
*
|
|
* @return The DataSnapshot's contents as a JavaScript value (Object,
|
|
* Array, string, number, boolean, or `null`).
|
|
*/
|
|
val() {
|
|
const parts = (0, path_1.pathParts)(this._childPath);
|
|
const source = this._data;
|
|
const node = _.cloneDeep(parts.length ? _.get(source, parts, null) : source);
|
|
return this._checkAndConvertToArray(node);
|
|
}
|
|
/**
|
|
* Exports the entire contents of the `DataSnapshot` as a JavaScript object.
|
|
*
|
|
* The `exportVal()` method is similar to `val()`, except priority information
|
|
* is included (if available), making it suitable for backing up your data.
|
|
*
|
|
* @return The contents of the `DataSnapshot` as a JavaScript value
|
|
* (Object, Array, string, number, boolean, or `null`).
|
|
*/
|
|
exportVal() {
|
|
return this.val();
|
|
}
|
|
/**
|
|
* Gets the priority value of the data in this `DataSnapshot`.
|
|
*
|
|
* As an alternative to using priority, applications can order collections by
|
|
* ordinary properties. See [Sorting and filtering
|
|
* data](/docs/database/web/lists-of-data#sorting_and_filtering_data).
|
|
*
|
|
* @return The priority value of the data.
|
|
*/
|
|
getPriority() {
|
|
return 0;
|
|
}
|
|
/**
|
|
* Returns `true` if this `DataSnapshot` contains any data. It is slightly more
|
|
* efficient than using `snapshot.val() !== null`.
|
|
*
|
|
* @return `true` if this `DataSnapshot` contains any data; otherwise, `false`.
|
|
*/
|
|
exists() {
|
|
return !_.isNull(this.val());
|
|
}
|
|
/**
|
|
* Gets a `DataSnapshot` for the location at the specified relative path.
|
|
*
|
|
* The relative path can either be a simple child name (for example, "ada") or
|
|
* a deeper slash-separated path (for example, "ada/name/first").
|
|
*
|
|
* @param path A relative path from this location to the desired child
|
|
* location.
|
|
* @return The specified child location.
|
|
*/
|
|
child(childPath) {
|
|
if (!childPath) {
|
|
return this;
|
|
}
|
|
return this._dup(childPath);
|
|
}
|
|
/**
|
|
* Enumerates the `DataSnapshot`s of the children items.
|
|
*
|
|
* Because of the way JavaScript objects work, the ordering of data in the
|
|
* JavaScript object returned by `val()` is not guaranteed to match the ordering
|
|
* on the server nor the ordering of `child_added` events. That is where
|
|
* `forEach()` comes in handy. It guarantees the children of a `DataSnapshot`
|
|
* will be iterated in their query order.
|
|
*
|
|
* If no explicit `orderBy*()` method is used, results are returned
|
|
* ordered by key (unless priorities are used, in which case, results are
|
|
* returned by priority).
|
|
*
|
|
* @param action A function that will be called for each child `DataSnapshot`.
|
|
* The callback can return `true` to cancel further enumeration.
|
|
*
|
|
* @return `true` if enumeration was canceled due to your callback
|
|
* returning `true`.
|
|
*/
|
|
forEach(action) {
|
|
const val = this.val();
|
|
if (_.isPlainObject(val)) {
|
|
return _.some(val, (value, key) => action(this.child(key)) === true);
|
|
}
|
|
return false;
|
|
}
|
|
/**
|
|
* Returns `true` if the specified child path has (non-`null`) data.
|
|
*
|
|
* @param path A relative path to the location of a potential child.
|
|
* @return `true` if data exists at the specified child path; otherwise,
|
|
* `false`.
|
|
*/
|
|
hasChild(childPath) {
|
|
return this.child(childPath).exists();
|
|
}
|
|
/**
|
|
* Returns whether or not the `DataSnapshot` has any non-`null` child
|
|
* properties.
|
|
*
|
|
* You can use `hasChildren()` to determine if a `DataSnapshot` has any
|
|
* children. If it does, you can enumerate them using `forEach()`. If it
|
|
* doesn't, then either this snapshot contains a primitive value (which can be
|
|
* retrieved with `val()`) or it is empty (in which case, `val()` will return
|
|
* `null`).
|
|
*
|
|
* @return `true` if this snapshot has any children; else `false`.
|
|
*/
|
|
hasChildren() {
|
|
const val = this.val();
|
|
return _.isPlainObject(val) && _.keys(val).length > 0;
|
|
}
|
|
/**
|
|
* Returns the number of child properties of this `DataSnapshot`.
|
|
*
|
|
* @return Number of child properties of this `DataSnapshot`.
|
|
*/
|
|
numChildren() {
|
|
const val = this.val();
|
|
return _.isPlainObject(val) ? Object.keys(val).length : 0;
|
|
}
|
|
/**
|
|
* Returns a JSON-serializable representation of this object.
|
|
*
|
|
* @return A JSON-serializable representation of this object.
|
|
*/
|
|
toJSON() {
|
|
return this.val();
|
|
}
|
|
/** Recursive function to check if keys are numeric & convert node object to array if they are
|
|
*
|
|
* @hidden
|
|
*/
|
|
_checkAndConvertToArray(node) {
|
|
if (node === null || typeof node === 'undefined') {
|
|
return null;
|
|
}
|
|
if (typeof node !== 'object') {
|
|
return node;
|
|
}
|
|
const obj = {};
|
|
let numKeys = 0;
|
|
let maxKey = 0;
|
|
let allIntegerKeys = true;
|
|
for (const key in node) {
|
|
if (!node.hasOwnProperty(key)) {
|
|
continue;
|
|
}
|
|
const childNode = node[key];
|
|
obj[key] = this._checkAndConvertToArray(childNode);
|
|
numKeys++;
|
|
const integerRegExp = /^(0|[1-9]\d*)$/;
|
|
if (allIntegerKeys && integerRegExp.test(key)) {
|
|
maxKey = Math.max(maxKey, Number(key));
|
|
}
|
|
else {
|
|
allIntegerKeys = false;
|
|
}
|
|
}
|
|
if (allIntegerKeys && maxKey < 2 * numKeys) {
|
|
// convert to array.
|
|
const array = [];
|
|
_.forOwn(obj, (val, key) => {
|
|
array[key] = val;
|
|
});
|
|
return array;
|
|
}
|
|
return obj;
|
|
}
|
|
/** @hidden */
|
|
_dup(childPath) {
|
|
const dup = new DataSnapshot(this._data, undefined, this.app, this.instance);
|
|
[dup._path, dup._childPath] = [this._path, this._childPath];
|
|
if (childPath) {
|
|
dup._childPath = (0, path_1.joinPath)(dup._childPath, childPath);
|
|
}
|
|
return dup;
|
|
}
|
|
/** @hidden */
|
|
_fullPath() {
|
|
const out = (this._path || '') + '/' + (this._childPath || '');
|
|
return out;
|
|
}
|
|
}
|
|
exports.DataSnapshot = DataSnapshot;
|