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») к определенному полю. |
параметры | Параметры моментального снимка | Объект параметров, позволяющий настроить способ извлечения поля из снимка (например, желаемое поведение для временных меток сервера, которым еще не присвоено окончательное значение). |
Возврат:
любой
Данные в указанном местоположении поля или неопределенные, если такое поле не существует в документе.