Schnittstelle, die einen Daten-Snapshot einer Firebase Realtime-Datenbank darstellt.
Unterschrift:
export declare class DataSnapshot implements database.DataSnapshot
Implementiert: Datenbank.DataSnapshot
Konstrukteure
Konstrukteur | Modifikatoren | Beschreibung |
---|---|---|
(Konstruktor)(Daten, Pfad, App, Instanz) | Konstruiert eine neue Instanz der DataSnapshot Klasse |
Eigenschaften
Eigentum | Modifikatoren | Typ | Beschreibung |
---|---|---|---|
Beispiel | Zeichenfolge | ||
Schlüssel | Zeichenfolge | Null | Der Schlüssel (letzter Teil des Pfads) des Speicherorts dieses DataSnapshot . Das letzte Token an einem Datenbankstandort wird als dessen Schlüssel betrachtet. „ada“ ist beispielsweise der Schlüssel für den Knoten /users/ada/ . Beim Zugriff auf den Schlüssel in einem beliebigen DataSnapshot wird der Schlüssel für den Speicherort zurückgegeben, der ihn generiert hat. Der Zugriff auf den Schlüssel über die Stamm-URL einer Datenbank gibt jedoch null zurück. | |
ref | Datenbank.Referenz | Gibt eine [ Reference ](/docs/reference/admin/node/admin.database.Reference) auf den Datenbankspeicherort zurück, an dem der auslösende Schreibvorgang stattgefunden hat. Hat vollen Lese- und Schreibzugriff. |
Methoden
Methode | Modifikatoren | Beschreibung |
---|---|---|
child(childPath) | Ruft einen DataSnapshot für den Speicherort am angegebenen relativen Pfad ab. Der relative Pfad kann entweder ein einfacher untergeordneter Name (z. B. „ada“) oder ein tieferer, durch Schrägstriche getrennter Pfad (z. B. „ada/name/first“) sein. | |
existiert() | Gibt true zurück, wenn dieser DataSnapshot Daten enthält. Es ist etwas effizienter als die Verwendung von snapshot.val() !== null . true , wenn dieser DataSnapshot Daten enthält; andernfalls false . | |
exportVal() | Exportiert den gesamten Inhalt des DataSnapshot als JavaScript-Objekt. Der Inhalt des DataSnapshot als JavaScript-Wert (Objekt, Array, Zeichenfolge, Zahl, boolescher Wert oder null ). | |
forEach(Aktion) | Listet die DataSnapshot s der untergeordneten Elemente auf. Aufgrund der Funktionsweise von JavaScript-Objekten kann nicht garantiert werden, dass die Reihenfolge der Daten im von val() zurückgegebenen JavaScript-Objekt mit der Reihenfolge auf dem Server oder der Reihenfolge von child_added Ereignissen übereinstimmt. Hier kommt forEach() zum Einsatz. Es garantiert, dass die untergeordneten Elemente eines DataSnapshot in ihrer Abfragereihenfolge iteriert werden können. Wenn keine explizite orderBy*() Methode verwendet wird, werden die Ergebnisse nach Schlüssel sortiert zurückgegeben (es sei denn, es werden Prioritäten verwendet; in diesem Fall werden die Ergebnisse nach Priorität zurückgegeben). | |
getPriority() | Ruft den Prioritätswert der Daten in diesem DataSnapshot ab. Als Alternative zur Verwendung der Priorität können Anwendungen Sammlungen nach gewöhnlichen Eigenschaften ordnen. Siehe [Daten sortieren und filtern](/docs/database/web/lists-of-data#sorting_and_filtering_data). Der Prioritätswert der Daten. | |
hasChild(childPath) | Gibt true zurück, wenn der angegebene untergeordnete Pfad Daten (nicht null ) enthält. | |
hat Kinder() | Gibt zurück, ob der DataSnapshot über untergeordnete Eigenschaften ungleich null verfügt. Sie können hasChildren() verwenden, um festzustellen, ob ein DataSnapshot untergeordnete Elemente hat. Wenn dies der Fall ist, können Sie sie mit forEach() aufzählen. Wenn dies nicht der Fall ist, enthält dieser Snapshot entweder einen primitiven Wert (der mit val() abgerufen werden kann) oder er ist leer (in diesem Fall gibt val() null zurück). true , wenn dieser Snapshot untergeordnete Elemente hat; sonst false . | |
numChildren() | Gibt die Anzahl der untergeordneten Eigenschaften dieses DataSnapshot zurück. Anzahl der untergeordneten Eigenschaften dieses DataSnapshot . | |
toJSON() | Gibt eine JSON-serialisierbare Darstellung dieses Objekts zurück. Eine JSON-serialisierbare Darstellung dieses Objekts. | |
val() | Extrahiert einen JavaScript-Wert aus einem DataSnapshot . Abhängig von den Daten in einem DataSnapshot kann die val() Methode einen Skalartyp (Zeichenfolge, Zahl oder boolescher Wert), ein Array oder ein Objekt zurückgeben. Es kann auch null zurückgegeben werden, was darauf hinweist, dass der DataSnapshot leer ist (keine Daten enthält). Der Inhalt des Snapshots als JavaScript-Wert (Objekt, Array, Zeichenfolge, Zahl, boolescher Wert oder null ). |
Datenbank.DataSnapshot.(Konstruktor)
Konstruiert eine neue Instanz der DataSnapshot
Klasse
Unterschrift:
constructor(data: any, path?: string, // path is undefined for the database root
app?: App, instance?: string);
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Daten | beliebig | |
Weg | Zeichenfolge | |
App | App | |
Beispiel | Zeichenfolge |
Datenbank.DataSnapshot.instance
Unterschrift:
instance: string;
Datenbank.DataSnapshot.key
Der Schlüssel (letzter Teil des Pfads) des Speicherorts dieses DataSnapshot
.
Das letzte Token an einem Datenbankstandort wird als dessen Schlüssel betrachtet. „ada“ ist beispielsweise der Schlüssel für den Knoten /users/ada/
. Beim Zugriff auf den Schlüssel in einem beliebigen DataSnapshot
wird der Schlüssel für den Speicherort zurückgegeben, der ihn generiert hat. Der Zugriff auf den Schlüssel über die Stamm-URL einer Datenbank gibt jedoch null
zurück .
Unterschrift:
get key(): string | null;
Datenbank.DataSnapshot.ref
Gibt eine [ Reference
zurück ](/docs/reference/admin/node/admin.database.Reference) zum Datenbankspeicherort, an dem der auslösende Schreibvorgang stattgefunden hat. Hat vollen Lese- und Schreibzugriff.
Unterschrift:
get ref(): database.Reference;
Datenbank.DataSnapshot.child()
Ruft einen DataSnapshot
für den Speicherort am angegebenen relativen Pfad ab.
Der relative Pfad kann entweder ein einfacher untergeordneter Name (z. B. „ada“) oder ein tieferer, durch Schrägstriche getrennter Pfad (z. B. „ada/name/first“) sein.
Unterschrift:
child(childPath: string): DataSnapshot;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
childPath | Zeichenfolge |
Kehrt zurück:
Datenbank.DataSnapshot.exists()
Gibt true
zurück, wenn dieser DataSnapshot
Daten enthält. Es ist etwas effizienter als die Verwendung von snapshot.val() !== null
.
true
, wenn dieser DataSnapshot
Daten enthält; andernfalls false
.
Unterschrift:
exists(): boolean;
Kehrt zurück:
Boolescher Wert
Datenbank.DataSnapshot.exportVal()
Exportiert den gesamten Inhalt des DataSnapshot
als JavaScript-Objekt.
Der Inhalt des DataSnapshot
als JavaScript-Wert (Objekt, Array, Zeichenfolge, Zahl, boolescher Wert oder null
).
Unterschrift:
exportVal(): any;
Kehrt zurück:
beliebig
Datenbank.DataSnapshot.forEach()
Listet den DataSnapshot
auf s der Kinderelemente.
Aufgrund der Funktionsweise von JavaScript-Objekten kann nicht garantiert werden, dass die Reihenfolge der Daten im von val()
zurückgegebenen JavaScript-Objekt mit der Reihenfolge auf dem Server oder der Reihenfolge von child_added
Ereignissen übereinstimmt. Hier kommt forEach()
zum Einsatz. Es garantiert, dass die untergeordneten Elemente eines DataSnapshot
in ihrer Abfragereihenfolge iteriert werden können.
Wenn keine explizite orderBy*()
Methode verwendet wird, werden die Ergebnisse nach Schlüssel sortiert zurückgegeben (es sei denn, es werden Prioritäten verwendet; in diesem Fall werden die Ergebnisse nach Priorität zurückgegeben).
Unterschrift:
forEach(action: (a: DataSnapshot) => boolean | void): boolean;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Aktion | (a: DataSnapshot ) => boolean | Leere | Eine Funktion, die für jeden untergeordneten DataSnapshot aufgerufen wird. Der Rückruf kann true zurückgeben, um die weitere Aufzählung abzubrechen. true , wenn die Enumeration abgebrochen wurde, weil Ihr Rückruf true zurückgegeben hat. |
Kehrt zurück:
Boolescher Wert
Datenbank.DataSnapshot.getPriority()
Ruft den Prioritätswert der Daten in diesem DataSnapshot
ab .
Als Alternative zur Verwendung der Priorität können Anwendungen Sammlungen nach gewöhnlichen Eigenschaften ordnen. Siehe [Daten sortieren und filtern](/docs/database/web/lists-of-data#sorting_and_filtering_data).
Der Prioritätswert der Daten.
Unterschrift:
getPriority(): string | number | null;
Kehrt zurück:
Zeichenfolge | Nummer | Null
Datenbank.DataSnapshot.hasChild()
Gibt true
zurück, wenn der angegebene untergeordnete Pfad (nicht null
hat ) Daten.
Unterschrift:
hasChild(childPath: string): boolean;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
childPath | Zeichenfolge |
Kehrt zurück:
Boolescher Wert
Datenbank.DataSnapshot.hasChildren()
Gibt zurück, ob der DataSnapshot
über untergeordnete Eigenschaften ungleich null
verfügt.
Sie können hasChildren()
verwenden, um festzustellen, ob ein DataSnapshot
untergeordnete Elemente hat. Wenn dies der Fall ist, können Sie sie mit forEach()
aufzählen. . Wenn dies nicht der Fall ist, enthält dieser Snapshot entweder einen primitiven Wert (der mit val()
) oder es ist leer (in diesem Fall gibt val()
null
zurück ).
true
, wenn dieser Snapshot untergeordnete Elemente hat; sonst false
.
Unterschrift:
hasChildren(): boolean;
Kehrt zurück:
Boolescher Wert
Datenbank.DataSnapshot.numChildren()
Gibt die Anzahl der untergeordneten Eigenschaften dieses DataSnapshot
zurück .
Anzahl der untergeordneten Eigenschaften dieses DataSnapshot
.
Unterschrift:
numChildren(): number;
Kehrt zurück:
Nummer
Datenbank.DataSnapshot.toJSON()
Gibt eine JSON-serialisierbare Darstellung dieses Objekts zurück.
Eine JSON-serialisierbare Darstellung dieses Objekts.
Unterschrift:
toJSON(): Record<string, unknown>;
Kehrt zurück:
Record<string, unbekannt>
Datenbank.DataSnapshot.val()
Extrahiert einen JavaScript-Wert aus einem DataSnapshot
.
Abhängig von den Daten in einem DataSnapshot
, kann die val()
-Methode einen Skalartyp (Zeichenfolge, Zahl oder boolescher Wert), ein Array oder ein Objekt zurückgeben. Es kann auch null
zurückgegeben werden , was anzeigt, dass der DataSnapshot
leer ist (keine Daten enthält).
Der Inhalt des Snapshots als JavaScript-Wert (Objekt, Array, Zeichenfolge, Zahl, Boolescher Wert oder null
).
Unterschrift:
val(): any;
Kehrt zurück:
beliebig