QueryDocumentSnapshot chứa dữ liệu được đọc từ một tài liệu trong cơ sở dữ liệu Firestore dưới dạng một phần của truy vấn. Chúng tôi đảm bảo tài liệu này luôn tồn tại và bạn có thể trích xuất dữ liệu trong đó bằng .data() hoặc .get(<field>) để lấy một trường cụ thể.
QueryDocumentSnapshot cung cấp nền tảng API tương tự như DocumentSnapshot. Vì kết quả truy vấn chỉ chứa các tài liệu hiện có, nên thuộc tính exists sẽ luôn đúng và data() sẽ không bao giờ trả về "không xác định".
Chữ ký:
export declare class QueryDocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> extends DocumentSnapshot<AppModelType, DbModelType>
Mở rộng: DocumentSnapshot<AppModelType, DbModelType>
Phương thức
| Phương thức | Công cụ sửa đổi | Mô tả |
|---|---|---|
| dữ liệu(tuỳ chọn) | Truy xuất tất cả các trường trong tài liệu dưới dạng Object.Theo mặc định, các giá trị serverTimestamp() chưa được thiết lập thành giá trị cuối cùng sẽ được trả về dưới dạng null. Bạn có thể ghi đè giá trị này bằng cách truyền một đối tượng tuỳ chọn. |
QueryDocumentSnapshot.data()
Truy xuất tất cả các trường trong tài liệu dưới dạng Object.
Theo mặc định, các giá trị serverTimestamp() chưa được đặt thành giá trị cuối cùng sẽ được trả về là null. Bạn có thể ghi đè giá trị này bằng cách truyền một đối tượng tuỳ chọn.
Chữ ký:
/** @override */
data(options?: SnapshotOptions): AppModelType;
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
| tuỳ chọn | Tuỳ chọn ảnh chụp nhanh | Một đối tượng tuỳ chọn để định cấu hình cách truy xuất dữ liệu qua bản tổng quan nhanh (ví dụ: hành vi mong muốn đối với dấu thời gian của máy chủ chưa được đặt thành giá trị cuối cùng). |
Trường hợp trả lại hàng:
Loại mô hình ứng dụng
Object chứa tất cả các trường trong tài liệu.