תמונת DocumentSnapshot
מכילה נתונים שנקראו ממסמך במסד הנתונים של Firestore. ניתן לחלץ את הנתונים עם .data()
או .get(<field>)
כדי לקבל שדה ספציפי.
עבור DocumentSnapshot
המצביע על מסמך לא קיים, כל גישה לנתונים תחזיר 'לא מוגדר'. אתה יכול להשתמש בשיטת exists()
כדי לאמת במפורש את קיומו של מסמך.
חֲתִימָה:
export declare class DocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData>
בונים
בַּנַאִי | משנה | תיאור |
---|---|---|
(בַּנַאִי)() | בונה מופע חדש של המחלקה DocumentSnapshot |
נכסים
תכונה | משנה | סוּג | תיאור |
---|---|---|---|
תְעוּדַת זֶהוּת | חוּט | מאפיין של DocumentSnapshot המספק את מזהה המסמך. | |
מטא נתונים | SnapshotMetadata | מטא נתונים על ה- DocumentSnapshot , כולל מידע על המקור שלו ושינויים מקומיים. | |
ref | הפניה למסמך <AppModelType, DbModelType> | ה- DocumentReference עבור המסמך הכלול ב- DocumentSnapshot . |
שיטות
שיטה | משנה | תיאור |
---|---|---|
נתונים (אפשרויות) | מאחזר את כל השדות במסמך Object . מחזירה undefined אם המסמך לא קיים. כברירת מחדל, ערכי serverTimestamp() שעדיין לא הוגדרו לערך הסופי שלהם יוחזרו כ- null . אתה יכול לעקוף זאת על ידי העברת אובייקט אפשרויות. | |
קיים() | מחזירה אם הנתונים קיימים או לא. נכון אם המסמך קיים. | |
get(fieldPath, options) | מאחזר את השדה שצוין על ידי fieldPath . מחזירה undefined אם המסמך או השדה אינם קיימים. כברירת מחדל, serverTimestamp() שעדיין לא הוגדר לערך הסופי שלו יוחזר כ- null . אתה יכול לעקוף זאת על ידי העברת אובייקט אפשרויות. |
DocumentSnapshot.(קונסטרוקטור)
בונה מופע חדש של המחלקה DocumentSnapshot
חֲתִימָה:
protected constructor();
DocumentSnapshot.id
מאפיין של DocumentSnapshot
המספק את מזהה המסמך.
חֲתִימָה:
get id(): string;
DocumentSnapshot.metadata
מטא נתונים על ה- DocumentSnapshot
, כולל מידע על מקורו ושינויים מקומיים.
חֲתִימָה:
readonly metadata: SnapshotMetadata;
DocumentSnapshot.ref
ה- DocumentReference
עבור המסמך הכלול ב- DocumentSnapshot
.
חֲתִימָה:
get ref(): DocumentReference<AppModelType, DbModelType>;
DocumentSnapshot.data()
מאחזר את כל השדות במסמך Object
. מחזירה undefined
אם המסמך לא קיים.
כברירת מחדל, ערכי serverTimestamp()
שעדיין לא הוגדרו לערך הסופי שלהם יוחזרו כ- null
. אתה יכול לעקוף זאת על ידי העברת אובייקט אפשרויות.
חֲתִימָה:
data(options?: SnapshotOptions): AppModelType | undefined;
פרמטרים
פָּרָמֶטֶר | סוּג | תיאור |
---|---|---|
אפשרויות | אפשרויות Snapshot | אובייקט אופציות להגדרת אופן אחזור הנתונים מתמונת המצב (לדוגמה ההתנהגות הרצויה עבור חותמות זמן של שרת שעדיין לא הוגדרו לערך הסופי שלהן). |
החזרות:
AppModelType | לא מוגדר
Object
המכיל את כל השדות במסמך או undefined
אם המסמך אינו קיים.
DocumentSnapshot.exists()
מחזירה אם הנתונים קיימים או לא. נכון אם המסמך קיים.
חֲתִימָה:
exists(): this is QueryDocumentSnapshot<AppModelType, DbModelType>;
החזרות:
זהו QueryDocumentSnapshot <AppModelType, DbModelType>
DocumentSnapshot.get()
מאחזר את השדה שצוין על ידי fieldPath
. מחזירה undefined
אם המסמך או השדה אינם קיימים.
כברירת מחדל, serverTimestamp()
שעדיין לא הוגדר לערך הסופי שלו יוחזר כ- null
. אתה יכול לעקוף זאת על ידי העברת אובייקט אפשרויות.
חֲתִימָה:
get(fieldPath: string | FieldPath, options?: SnapshotOptions): any;
פרמטרים
פָּרָמֶטֶר | סוּג | תיאור |
---|---|---|
fieldPath | מחרוזת | FieldPath | הנתיב (לדוגמה 'foo' או 'foo.bar') לשדה ספציפי. |
אפשרויות | אפשרויות Snapshot | אובייקט אפשרויות להגדיר כיצד השדה מאוחזר מתמונת המצב (לדוגמה ההתנהגות הרצויה עבור חותמות זמן של שרת שעדיין לא הוגדרו לערך הסופי שלהן). |
החזרות:
כל
הנתונים במיקום השדה שצוין או לא מוגדר אם לא קיים שדה כזה במסמך.