DocumentSnapshot class

DocumentSnapshot содержит данные, считанные из документа в вашей базе данных Firestore. Данные можно извлечь с помощью .data() или .get(<field>) для получения определенного поля.

Для DocumentSnapshot , который указывает на несуществующий документ, любой доступ к данным вернет «неопределенное». Вы можете использовать метод exists() для явной проверки существования документа.

Подпись:

export declare class DocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> 

Конструкторы

Конструктор Модификаторы Описание
(конструктор)() Создает новый экземпляр класса DocumentSnapshot .

Характеристики

Свойство Модификаторы Тип Описание
идентификатор нить Свойство DocumentSnapshot , предоставляющее идентификатор документа.
метаданные Метаданные моментального снимка Метаданные о DocumentSnapshot , включая информацию о его источнике и локальных модификациях.
ссылка Ссылка на документ <AppModelType, DbModelType> DocumentReference для документа, включенного в DocumentSnapshot .

Методы

Метод Модификаторы Описание
данные (варианты) Извлекает все поля документа как Object . Возвращает undefined , если документ не существует. По умолчанию значения serverTimestamp() , которым еще не присвоено окончательное значение, будут возвращены как null . Вы можете переопределить это, передав объект параметров.
существует() Возвращает, существуют ли данные. Истинно, если документ существует.
получить (fieldPath, параметры) Извлекает поле, указанное в fieldPath . Возвращает undefined , если документ или поле не существует. По умолчанию для serverTimestamp() , которому еще не присвоено окончательное значение, будет возвращено значение null . Вы можете переопределить это, передав объект параметров.

DocumentSnapshot.(конструктор)

Создает новый экземпляр класса DocumentSnapshot .

Подпись:

protected constructor();

ДокументСнапшот.id

Свойство DocumentSnapshot , предоставляющее идентификатор документа.

Подпись:

get id(): string;

DocumentSnapshot.metadata

Метаданные о DocumentSnapshot , включая информацию о его источнике и локальных модификациях.

Подпись:

readonly metadata: SnapshotMetadata;

ДокументСнапшот.ref

DocumentReference для документа, включенного в DocumentSnapshot .

Подпись:

get ref(): DocumentReference<AppModelType, DbModelType>;

ДокументСнапшот.данные()

Извлекает все поля документа как Object . Возвращает undefined , если документ не существует.

По умолчанию значения serverTimestamp() , которым еще не присвоено окончательное значение, будут возвращены как null . Вы можете переопределить это, передав объект параметров.

Подпись:

data(options?: SnapshotOptions): AppModelType | undefined;

Параметры

Параметр Тип Описание
параметры Параметры моментального снимка Объект параметров для настройки способа получения данных из моментального снимка (например, желаемое поведение для временных меток сервера, которым еще не присвоено окончательное значение).

Возврат:

ТипМодели Приложения | неопределенный

Object , содержащий все поля в документе или undefined , если документ не существует.

ДокументСнапшот.exists()

Возвращает сведения о том, существуют ли данные. Истинно, если документ существует.

Подпись:

exists(): this is QueryDocumentSnapshot<AppModelType, DbModelType>;

Возврат:

это QueryDocumentSnapshot <AppModelType, DbModelType>

ДокументСнапшот.get()

Получает поле, указанное в fieldPath . Возвращает undefined , если документ или поле не существует.

По умолчанию для serverTimestamp() , которому еще не присвоено окончательное значение, будет возвращено значение null . Вы можете переопределить это, передав объект параметров.

Подпись:

get(fieldPath: string | FieldPath, options?: SnapshotOptions): any;

Параметры

Параметр Тип Описание
полеПуть строка | ФилдПат Путь (например, «foo» или «foo.bar») к определенному полю.
параметры Параметры моментального снимка Объект параметров, позволяющий настроить способ извлечения поля из снимка (например, желаемое поведение для временных меток сервера, которым еще не присвоено окончательное значение).

Возврат:

любой

Данные в указанном местоположении поля или неопределенные, если такое поле не существует в документе.