DocumentSnapshot class

DocumentSnapshot 包含從 Firestore 資料庫中文件讀取的資料。可使用 .data() 或 .get(<field>) 擷取資料以取得特定欄位。

如果 DocumentSnapshot 指向現有的文件，則任何資料存取均會傳回「未定義」。您可以使用 exists() 方法明確驗證文件是否存在。

簽名：

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

建構函式

建構函式	修飾符	說明
(建構函式)()		建構 DocumentSnapshot 類別的新例項

屬性

屬性	修飾符	類型	說明
id		字串	提供文件 ID 的 DocumentSnapshot 屬性。
參考資料		DocumentReference<AppModelType、DundModelType>	DocumentSnapshot 中文件的 DocumentReference。

方法

方法	修飾符	說明
data()		將文件中的所有欄位擷取為 Object。如果文件不存在，則傳回 undefined。
exists()		指明快照位置的文件是否存在。
get(fieldPath)		擷取 fieldPath 指定的欄位。如果文件或欄位不存在，則傳回 undefined。

DocumentSnapshot.(建構函式)

建構 DocumentSnapshot 類別的新例項

簽名：

protected constructor();

DocumentSnapshot.id

提供文件 ID 的 DocumentSnapshot 屬性。

簽名：

get id(): string;

DocumentSnapshot.ref

DocumentSnapshot 中所包含文件的 DocumentReference。

簽名：

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

DocumentSnapshot.data()

將文件中的所有欄位擷取為 Object。如果文件不存在，則傳回 undefined。

簽名：

data(): AppModelType | undefined;

傳回：

AppModelType |未定義

Object 包含文件中的所有欄位；如果文件不存在，則為 undefined。

DocumentSnapshot.exists()

指明快照位置的文件是否存在。

簽名：

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

傳回：

這是 QueryDocumentSnapshot<AppModelType, DBMModelType>

如果文件存在，則為 true。

DocumentSnapshot.get()

擷取 fieldPath 指定的欄位。如果文件或欄位不存在，則傳回 undefined。

簽名：

get(fieldPath: string | FieldPath): any;

參數

參數	類型	說明
欄位路徑	字串 |FieldPath	特定欄位的路徑 (例如「foo」或「foo.bar」)。

傳回：

不限

指定欄位位置中的資料；如果文件中沒有這類欄位，則顯示未定義的資料。