Ein DocumentSnapshot
enthält Daten, die aus einem Dokument in Ihrer Firestore-Datenbank gelesen wurden. Die Daten können mit .data()
oder .get(<field>)
extrahiert werden, um ein bestimmtes Feld zu erhalten.
Bei einem DocumentSnapshot
, der auf ein nicht vorhandenes Dokument verweist, gibt jeder Datenzugriff „undefiniert“ zurück. Sie können die Methode exists()
verwenden, um die Existenz eines Dokuments explizit zu überprüfen.
Unterschrift:
export declare class DocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData>
Konstrukteure
Konstrukteur | Modifikatoren | Beschreibung |
---|---|---|
(Konstrukteur)() | Konstruiert eine neue Instanz der DocumentSnapshot Klasse |
Eigenschaften
Eigentum | Modifikatoren | Typ | Beschreibung |
---|---|---|---|
Ausweis | Zeichenfolge | Eigenschaft des DocumentSnapshot , die die ID des Dokuments bereitstellt. | |
Metadaten | SnapshotMetadata | Metadaten zum DocumentSnapshot , einschließlich Informationen zu seiner Quelle und lokalen Änderungen. | |
ref | Dokumentverweis <AppModelType, DbModelType> | Die DocumentReference für das im DocumentSnapshot enthaltene Dokument. |
Methoden
Methode | Modifikatoren | Beschreibung |
---|---|---|
Daten(Optionen) | Ruft alle Felder im Dokument als Object ab. Gibt undefined zurück, wenn das Dokument nicht existiert. Standardmäßig werden serverTimestamp() Werte, die noch nicht auf ihren endgültigen Wert gesetzt wurden, als null zurückgegeben. Sie können dies überschreiben, indem Sie ein Optionsobjekt übergeben. | |
existiert() | Gibt zurück, ob die Daten vorhanden sind oder nicht. True, wenn das Dokument vorhanden ist. | |
get(fieldPath, Optionen) | Ruft das durch fieldPath angegebene Feld ab. Gibt undefined zurück, wenn das Dokument oder Feld nicht existiert. Standardmäßig wird ein serverTimestamp() , der noch nicht auf seinen endgültigen Wert gesetzt wurde, als null zurückgegeben. Sie können dies überschreiben, indem Sie ein Optionsobjekt übergeben. |
DocumentSnapshot.(Konstruktor)
Konstruiert eine neue Instanz der DocumentSnapshot
Klasse
Unterschrift:
protected constructor();
DocumentSnapshot.id
Eigenschaft des DocumentSnapshot
, die die ID des Dokuments bereitstellt.
Unterschrift:
get id(): string;
DocumentSnapshot.metadata
Metadaten zum DocumentSnapshot
, einschließlich Informationen über seine Quelle und lokale Änderungen.
Unterschrift:
readonly metadata: SnapshotMetadata;
DocumentSnapshot.ref
Die DocumentReference
für das im DocumentSnapshot
enthaltene Dokument .
Unterschrift:
get ref(): DocumentReference<AppModelType, DbModelType>;
DocumentSnapshot.data()
Ruft alle Felder im Dokument als Object
. Gibt undefined
zurück, wenn das Dokument nicht existiert.
Standardmäßig werden serverTimestamp()
Werte, die noch nicht auf ihren endgültigen Wert gesetzt wurden, als null
zurückgegeben . Sie können dies überschreiben, indem Sie ein Optionsobjekt übergeben.
Unterschrift:
data(options?: SnapshotOptions): AppModelType | undefined;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Optionen | SnapshotOptions | Ein Optionsobjekt zum Konfigurieren, wie Daten aus dem Snapshot abgerufen werden (z. B. das gewünschte Verhalten für Server-Zeitstempel, die noch nicht auf ihren endgültigen Wert gesetzt wurden). |
Kehrt zurück:
AppModelType | nicht definiert
Ein Object
, das alle Felder im Dokument enthält oder undefined
, wenn das Dokument nicht existiert.
DocumentSnapshot.exists()
Gibt zurück, ob die Daten vorhanden sind oder nicht. True, wenn das Dokument vorhanden ist.
Unterschrift:
exists(): this is QueryDocumentSnapshot<AppModelType, DbModelType>;
Kehrt zurück:
Dies ist QueryDocumentSnapshot <AppModelType, DbModelType>
DocumentSnapshot.get()
Ruft das durch fieldPath
angegebene Feld ab . Gibt undefined
zurück, wenn das Dokument oder Feld nicht vorhanden ist.
Standardmäßig wird ein serverTimestamp()
, der noch nicht auf seinen endgültigen Wert gesetzt wurde, als null
zurückgegeben . Sie können dies überschreiben, indem Sie ein Optionsobjekt übergeben.
Unterschrift:
get(fieldPath: string | FieldPath, options?: SnapshotOptions): any;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
fieldPath | Zeichenfolge | FieldPath | Der Pfad (zum Beispiel „foo“ oder „foo.bar“) zu einem bestimmten Feld. |
Optionen | SnapshotOptions | Ein Optionsobjekt zum Konfigurieren, wie das Feld aus dem Snapshot abgerufen wird (z. B. das gewünschte Verhalten für Server-Zeitstempel, die noch nicht auf ihren endgültigen Wert gesetzt wurden). |
Kehrt zurück:
beliebig
Die Daten an der angegebenen Feldposition oder undefiniert, wenn im Dokument kein solches Feld vorhanden ist.