يحتوي QueryDocumentSnapshot على بيانات تمت قراءتها من مستند في قاعدة بيانات Firestore كجزء من طلب بحث. يكون المستند مضمونًا ويمكن استخراج بياناته باستخدام .data() أو .get(<field>) للحصول على حقل محدّد.
توفّر QueryDocumentSnapshot مساحة عرض واجهة برمجة التطبيقات نفسها التي توفّرها DocumentSnapshot. بما أنّ نتائج طلب البحث تحتوي على مستندات موجودة فقط، ستكون السمة exists صحيحة دائمًا ولن تعرض السمة data() أبدًا القيمة "غير محدّدة".
Signature:
export declare class QueryDocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> extends DocumentSnapshot<AppModelType, DbModelType>
الامتدادات: DocumentSnapshot<AppModelType, DbModelType>
الطُرق
| الطريقة | المعدِّلات | الوصف |
|---|---|---|
| data(options) | لاسترداد جميع الحقول في المستند بتنسيق Object.وبشكل تلقائي، سيتم عرض قيم serverTimestamp() التي لم يتم ضبطها بعد على قيمتها النهائية على أنّها null. يمكنك تجاوز هذا بتمرير كائن خيارات. |
QueryDocumentSnapshot.data()
استرداد جميع الحقول في المستند بتنسيق Object
بشكلٍ تلقائي، سيتم عرض قيم serverTimestamp() التي لم يتم ضبطها بعد على قيمتها النهائية كـ null. يمكنك تجاوز هذا بتمرير كائن خيارات.
Signature:
/** @override */
data(options?: SnapshotOptions): AppModelType;
المَعلمات
| المعلمة | النوع | الوصف |
|---|---|---|
| خيارات | SnapshotOptions | عنصر خيارات لضبط كيفية استرداد البيانات من اللقطة (على سبيل المثال، السلوك المطلوب للطوابع الزمنية للخادم التي لم يتم ضبطها بعد على قيمتها النهائية). |
المرتجعات:
نوع نموذج التطبيق
تمثّل هذه السمة Object يحتوي على جميع الحقول في المستند.