@firebase/firestore/lite

所提供應用程式的 Firestore 執行個體。

getFirestore(應用程式, 資料庫 ID)

這個 API 僅為開發人員的預先發布版，可能會根據收到的意見回饋有所變動。請勿在正式環境中使用這個 API，

傳回與所提供 FirebaseApp 相關聯的現有 Firestore 執行個體。如果沒有執行個體，則使用預設設定初始化新的執行個體。

簽名：

export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;

參數

參數	類型	說明
應用程式	Firebase 應用程式	傳回的 Firestore 執行個體已與 FirebaseApp 例項建立關聯。
資料庫 ID	字串	資料庫名稱。

傳回：

所提供應用程式的 Firestore 執行個體。

InitialFirestore(應用程式, 設定)

根據提供的設定來初始化新的 Cloud Firestore 執行個體。只能在其他任何函式之前呼叫，包括 getFirestore()。如果自訂設定空白，此函式就等同於呼叫 getFirestore()。

簽名：

export declare function initializeFirestore(app: FirebaseApp, settings: Settings): Firestore;

參數

參數	類型	說明
應用程式	Firebase 應用程式	與 `Firestore` 執行個體建立關聯的 FirebaseApp。
設定	設定	用於設定 `Firestore` 執行個體的設定物件。

傳回：

剛初始化的 Firestore 例項。

InitialFirestore(應用程式, 設定, 資料庫 ID)

這個 API 僅為開發人員的預先發布版，可能會根據收到的意見回饋有所變動。請勿在正式環境中使用這個 API，

簽名：

export declare function initializeFirestore(app: FirebaseApp, settings: Settings, databaseId?: string): Firestore;

參數

參數	類型	說明
應用程式	Firebase 應用程式	與 `Firestore` 執行個體建立關聯的 FirebaseApp。
設定	設定	用於設定 `Firestore` 執行個體的設定物件。
資料庫 ID	字串	資料庫名稱。

傳回：

剛初始化的 Firestore 例項。

函式(Firestore, ...)

收集(Firestore, path, pathSegments)

取得參照指定絕對路徑集合的 CollectionReference 例項。

簽名：

export declare function collection(firestore: Firestore, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

參數

參數	類型	說明
firestore	Firestore	根 `Firestore` 執行個體的參照。
路徑	字串	以斜線分隔的路徑，指向集合。
路徑區隔	string[]	相對於第一個引數要套用的其他路徑區段。

傳回：

CollectionReference<DocumentData、DocumentData>

CollectionReference 例項。

例外狀況

如果最終路徑的線段數為偶數，且並不指向集合，

collectionGroup(firestore, collectionId)

建立並傳回新的 Query 執行個體，其中包含資料庫內含使用 collectionId 的集合或子集合中的所有文件。

簽名：

export declare function collectionGroup(firestore: Firestore, collectionId: string): Query<DocumentData, DocumentData>;

參數

參數	類型	說明
firestore	Firestore	根 `Firestore` 執行個體的參照。
收藏 ID	字串	識別要查詢的集合。凡是使用這個 ID 做為路徑最後一個區隔的集合或子集合，都會納入。不得包含斜線。

傳回：

查詢<DocumentData、DocumentData>

已建立Query。

connectFirestoreEmulator(Firestore、主機、通訊埠、選項)

修改這個執行個體，與 Cloud Firestore 模擬器通訊。

簽名：

export declare function connectFirestoreEmulator(firestore: Firestore, host: string, port: number, options?: {
    mockUserToken?: EmulatorMockTokenOptions | string;
}): void;

參數

參數	類型	說明
firestore	Firestore	要設定連線至模擬器的 `Firestore` 執行個體。
主機	字串	模擬器主機 (例如：localhost)。
通訊埠	數字	模擬器通訊埠 (例如：9000)。
選項	{ mockUserToken？：EmulatorMockTokenOptions \|字串；}

傳回：

void

doc(Firestore, path, pathSegments)

取得參照指定絕對路徑文件的 DocumentReference 例項。

簽名：

export declare function doc(firestore: Firestore, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

參數

參數	類型	說明
firestore	Firestore	根 `Firestore` 執行個體的參照。
路徑	字串	文件的斜線分隔路徑。
路徑區隔	string[]	將根據第一個引數套用的其他路徑區段。

傳回：

DocumentReference<DocumentData、DocumentData>

DocumentReference 例項。

例外狀況

如果最後一個路徑的路段數量奇怪，且未指向文件，

runTransaction(firestore, updateFunction, options)

執行指定的 updateFunction，然後嘗試修訂交易中套用的變更。如果在交易中讀取過任何文件，Cloud Firestore 會重試 updateFunction。如果嘗試 5 次後仍無法修訂，則交易會失敗。

單一交易允許的寫入次數上限是 500。

簽名：

export declare function runTransaction<T>(firestore: Firestore, updateFunction: (transaction: Transaction) => Promise<T>, options?: TransactionOptions): Promise<T>;

參數

參數	類型	說明
firestore	Firestore	用於執行這筆交易的 Firestore 資料庫參照。
updateFunction。	(交易：交易) =>承諾<T>	要在交易內容中執行的函式。
選項	交易選項	用於設定修訂嘗試次數上限的選項物件。

傳回：

承諾<T>

如果交易順利完成或明確取消 (updateFunction 傳回失敗的承諾)，這裡會傳回 updateFunction 傳回的承諾。否則，如果交易失敗，系統就會傳回拒絕承諾，並顯示對應的失敗錯誤。

終止(Firestore)

終止提供的 Firestore 執行個體。

呼叫 terminate() 後，只能使用 clearIndexedDbPersistence() 函式。任何其他函式都會擲回 FirestoreError。終止不會取消任何待處理的寫入作業，系統也不會解決任何等待伺服器回應的承諾。

如要在終止後重新啟動，請使用 getFirestore() 建立新的 Firestore 執行個體。

簽名：

export declare function terminate(firestore: Firestore): Promise<void>;

參數

參數	類型	說明
firestore	Firestore	要終止的 `Firestore` 執行個體。

傳回：

Promise<void>

執行個體成功終止時已解決的 Promise。

WriteBatch(Firestore)

建立寫入批次，用來以單一不可分割作業的形式執行多次寫入。單一 WriteBatch 允許的寫入次數上限為 500。

只有在傳回的承諾產品解析後，這些寫入結果才會反映在文件讀取作業中。如果用戶端處於離線狀態，寫入就會失敗。如想在用戶端上線前查看本機修改或緩衝區寫入作業，請使用完整 Firestore SDK。

簽名：

export declare function writeBatch(firestore: Firestore): WriteBatch;

參數

參數	類型	說明
firestore	Firestore

傳回：

WriteBatch

WriteBatch，可用於以不可分割的形式執行多項寫入作業。

function()

計數()

建立 AggregateField 物件，以計算查詢結果集中的文件數量。

簽名：

export declare function count(): AggregateField<number>;

傳回：

AggregateField<number>

deleteField()

傳回一個 sendinel 與 updateDoc() 或 setDoc() 與 {merge: true}，用於標示要刪除的欄位。

簽名：

export declare function deleteField(): FieldValue;

傳回：

文件 ID()

傳回特殊的印記 FieldPath，用來參照文件 ID。可在查詢中使用，依文件 ID 排序或篩選。

簽名：

export declare function documentId(): FieldPath;

傳回：

FieldPath

getFirestore()

傳回與預設 FirebaseApp 相關聯的現有預設 Firestore 執行個體。如果沒有執行個體，則使用預設設定初始化新的執行個體。

簽名：

export declare function getFirestore(): Firestore;

傳回：

所提供應用程式的 Firestore 執行個體。

伺服器時間戳記()

傳回與 setDoc() 或 updateDoc() 搭配使用的 insinel，在寫入的資料中加入伺服器產生的時間戳記。

簽名：

export declare function serverTimestamp(): FieldValue;

傳回：

function(databaseId, ...)

getFirestore(databaseId)

這個 API 僅為開發人員的預先發布版，可能會根據收到的意見回饋有所變動。請勿在正式環境中使用這個 API，

傳回與預設 FirebaseApp 相關聯的現有 Firestore 執行個體。如果沒有執行個體，則使用預設設定初始化新的執行個體。

簽名：

export declare function getFirestore(databaseId: string): Firestore;

參數

參數	類型	說明
資料庫 ID	字串	資料庫名稱。

傳回：

所提供應用程式的 Firestore 執行個體。

函式(元素, ...)

ArrayRemove(元素)

傳回可以與 setDoc() 搭配使用的特殊值，或指示伺服器從伺服器上現有的任何陣列值中移除指定元素。系統會從陣列中移除每個指定元素的所有例項。如果修改的欄位尚未是陣列，則會以空白陣列覆寫。

簽名：

export declare function arrayRemove(...elements: unknown[]): FieldValue;

參數

參數	類型	說明
elements	不明 []	要從陣列中移除的元素。

傳回：

用於 setDoc() 或 updateDoc() 呼叫的 FieldValue 智慧型傳送器

陣列 Union(元素)

傳回可以與 setDoc() 或 updateDoc() 搭配使用的特殊值，指示伺服器將特定元素與伺服器上現有的任何陣列值建立聯集。陣列中尚未有指定的每個指定元素，都會新增到結尾處。如果修改的欄位尚未是陣列，則會以包含完全指定元素的陣列覆寫該欄位。

簽名：

export declare function arrayUnion(...elements: unknown[]): FieldValue;

參數

參數	類型	說明
elements	不明 []	要聯集到陣列的元素。

傳回：

QueryFieldFilterConstraint

用於對 setDoc() 或 updateDoc() 的呼叫的 FieldValue 傳送器。

function(field, ...)

平均(欄位)

建立 AggregateField 物件，以計算查詢結果集內某範圍文件的平均值。

簽名：

export declare function average(field: string | FieldPath): AggregateField<number | null>;

參數

參數	類型	說明
欄位	字串 \|FieldPath	指定結果集的平均值欄位。

傳回：

AggregateField<數字 |空值>

total(field)

建立 AggregateField 物件，以便計算查詢結果集中指定欄位內指定欄位的總和。

簽名：

export declare function sum(field: string | FieldPath): AggregateField<number>;

參數

參數	類型	說明
欄位	字串 \|FieldPath	指定要用於結果集總和的欄位。

傳回：

AggregateField<number>

function(fieldPath, ...)

orderBy(fieldPath, directStr)

建立 QueryOrderByConstraint 會依據指定欄位將查詢結果排序 (選擇以遞減順序而非遞增順序)。

簽名：

export declare function orderBy(fieldPath: string | FieldPath, directionStr?: OrderByDirection): QueryOrderByConstraint;

參數

參數	類型	說明
欄位路徑	字串 \|FieldPath	要做為排序依據的欄位。
方向距離	OrderByDirection	選用的排序方向 (「asc」或「desc」)。如未指定，則會以遞增方式排序。

傳回：

QueryOrderByConstraint

已建立的 QueryOrderByConstraint。

where(fieldPath, opStr, value)

建立 QueryFieldFilterConstraint，要求文件必須包含指定欄位，且值應符合提供的關聯限制。

簽名：

export declare function where(fieldPath: string | FieldPath, opStr: WhereFilterOp, value: unknown): QueryFieldFilterConstraint;

參數

參數	類型	說明
欄位路徑	字串 \|FieldPath	要比較的路徑
奧普斯特	WhereFilterOp	作業字串 (例如「<」、「<="」、「==」、「<」、「<=」和「!=」)。
值	不明	用於比較的值

傳回：

已建立的 QueryFieldFilterConstraint。

function(fieldValues, ...)

endAt(fieldValues)

建立 QueryEndAtConstraint，根據查詢順序，將結果集修改成指定欄位的結尾。欄位值的順序必須與查詢子句的順序相符。

簽名：

export declare function endAt(...fieldValues: unknown[]): QueryEndAtConstraint;

參數

參數	類型	說明
欄位值	不明 []	此查詢結束依據的欄位值，按照查詢的順序排列。

傳回：

要傳遞至 query() 的 QueryEndAtConstraint

endBefore(fieldValues)

建立 QueryEndAtConstraint，根據查詢順序，將結果集修改成在提供的欄位之前的結尾。欄位值的順序必須與查詢子句的順序相符。

簽名：

export declare function endBefore(...fieldValues: unknown[]): QueryEndAtConstraint;

參數

參數	類型	說明
欄位值	不明 []	在此查詢之前結束這項查詢的欄位值，依查詢順序排序。

傳回：

要傳遞至 query() 的 QueryEndAtConstraint

startAfter(fieldValues)

建立 QueryStartAtConstraint，根據查詢的順序，將結果集修改成在提供的欄位之後開始。欄位值的順序必須與查詢子句的順序相符。

簽名：

export declare function startAfter(...fieldValues: unknown[]): QueryStartAtConstraint;

參數

參數	類型	說明
欄位值	不明 []	查詢之後要啟動這項查詢的欄位值 (按照查詢順序排列)。

傳回：

要傳遞至 query() 的 QueryStartAtConstraint

startAt(fieldValues)

建立 QueryStartAtConstraint，根據查詢順序，將結果集修改成從提供的欄位開始。欄位值的順序必須與查詢子句的順序相符。

簽名：

export declare function startAt(...fieldValues: unknown[]): QueryStartAtConstraint;

參數

參數	類型	說明
欄位值	不明 []	要開始這項查詢的欄位值，按照查詢的順序排列。

傳回：

要傳遞至 query() 的 QueryStartAtConstraint。

函式(左側, ...)

aggregateFieldEqual(左, 右)

比較兩個「AggregateField」例項代表相等。

簽名：

export declare function aggregateFieldEqual(left: AggregateField<unknown>, right: AggregateField<unknown>): boolean;

參數

參數	類型	說明
左	AggregateField<unknown>	將這個 AggregateField 與 `right` 進行比較。
右	AggregateField<unknown>	將這個 AggregateField 與 `left` 進行比較。

傳回：

布林值

aggregateQuerySnapshotEqual(左, )

比較兩個 AggregateQuerySnapshot 例項是否相等。

系統會將兩個 AggregateQuerySnapshot 執行個體視為「相等」是否有基本查詢相同且資料相同

簽名：

export declare function aggregateQuerySnapshotEqual<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(left: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>, right: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>): boolean;

參數

參數	類型	說明
左	AggregateQuerySnapshot<AggregateSpecType、AppModelType、DBMModelType>	第一個要比較的 `AggregateQuerySnapshot`。
右	AggregateQuerySnapshot<AggregateSpecType、AppModelType、DBMModelType>	第二個要比較的 `AggregateQuerySnapshot`。

傳回：

布林值

如果物件是「等於」(如上定義)，則為 true，否則為 false。

queryEqual(左, 右)

如果提供的查詢指向相同的集合，並套用相同的限制，則傳回 true。

簽名：

export declare function queryEqual<AppModelType, DbModelType extends DocumentData>(left: Query<AppModelType, DbModelType>, right: Query<AppModelType, DbModelType>): boolean;

參數

參數	類型	說明
左	查詢<AppModelType、DundModelType>	要比較的 `Query`。
右	查詢<AppModelType、DundModelType>	要比較的 `Query`。

傳回：

布林值

如果參照指向同一個 Firestore 資料庫中相同的位置，則為 true。

refEqual(左, 右)

如果提供的參照相等，則傳回 true。

簽名：

export declare function refEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>, right: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>): boolean;

參數

參數	類型	說明
左	DocumentReference<AppModelType、DundModelType>\|CollectionReference<AppModelType、DundModelType>	用於比較的參照。
右	DocumentReference<AppModelType、DundModelType>\|CollectionReference<AppModelType、DundModelType>	用於比較的參照。

傳回：

布林值

如果參照指向同一個 Firestore 資料庫中相同的位置，則為 true。

快照 Equal(左、右)

如果提供的快照相等，則傳回 true。

簽名：

export declare function snapshotEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>, right: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>): boolean;

參數

參數	類型	說明
左	DocumentSnapshot<AppModelType、DundModelType>\|查詢快照<AppModelType、DundModelType>	要比較的快照。
右	DocumentSnapshot<AppModelType、DundModelType>\|查詢快照<AppModelType、DundModelType>	要比較的快照。

傳回：

布林值

如果快照相同，則傳回 true。

function(限制, ...)

limit(限制)

建立只會傳回第一組相符文件的 QueryLimitConstraint。

簽名：

export declare function limit(limit: number): QueryLimitConstraint;

參數

參數	類型	說明
限制	數字	傳回的項目數量上限。

傳回：

QueryLimitConstraint

已建立的 QueryLimitConstraint。

limitToLast(限制)

建立只傳回最後一組相符文件的 QueryLimitConstraint。

您必須為 limitToLast 查詢指定至少一個 orderBy 子句，否則系統會在執行期間擲回例外狀況。

簽名：

export declare function limitToLast(limit: number): QueryLimitConstraint;

參數

參數	類型	說明
限制	數字	傳回的項目數量上限。

傳回：

QueryLimitConstraint

已建立的 QueryLimitConstraint。

function(logLevel, ...)

setLogLevel(logLevel)

設定 Cloud Firestore 記錄檔的詳細程度 (偵錯、錯誤或無訊息)。

簽名：

export declare function setLogLevel(logLevel: LogLevel): void;

參數

參數	類型	說明
logLevel	LogLevel	您設定的活動和錯誤記錄詳細程度。這可以是下列任一值： `debug` 適用於最詳細的記錄層級，主要用於偵錯。 `error` 即可只記錄錯誤。 `silent to turn off logging.`

傳回：

void

函式(n, ...)

遞增(n)

傳回可以與 setDoc() 或 updateDoc() 搭配使用的特殊值，指示伺服器根據指定值增加欄位的目前值。

如果運算元或目前的欄位值使用浮點精確度，所有算術都會遵循 IEEE 754 語意。如果兩個值都是整數，位於 JavaScript 安全數字範圍 (Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER) 外的值也可能會遺失。此外，在 Firestore 後端處理之後，所有整數作業的整數作業均為 -2^63 和 2^63-1 之間的上限。

如果目前欄位值不是 number 類型，或如果該欄位不存在，轉換會將欄位設為指定值。

簽名：

export declare function increment(n: number): FieldValue;

參數

參數	類型	說明
n	數字	要遞增的值。

傳回：

QueryCompositeFilterConstraint

用於 setDoc() 或 updateDoc() 呼叫的 FieldValue 智慧型傳送器

function(查詢, ...)

getAggregate(query, aggregateSpec)

以指定查詢結果集中的文件計算指定的匯總次數，而不必實際下載文件。

使用這個函式執行匯總是有效率的，因為只有最終匯總值，而非文件下載及下載如果結果集過大，無法完全下載 (數千份文件)，這個函式就能執行文件匯總作業。

簽名：

export declare function getAggregate<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, aggregateSpec: AggregateSpecType): Promise<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>>;

參數

參數	類型	說明
查詢	查詢<AppModelType、DundModelType>	系統會匯總其結果集的查詢。
匯總規格	匯總規格類型	`AggregateSpec` 物件，用來指定要對結果集執行的匯總作業。AggregateSpec 會指定每個匯總的別名，可用於擷取匯總結果。

傳回：

Promise<AggregateQuerySnapshot<AggregateSpecType、AppModelType、DundModelType>>

範例

const aggregateSnapshot = await getAggregate(query, {
  countOfDocs: count(),
  totalHours: sum('hours'),
  averageScore: average('score')
});

const countOfDocs: number = aggregateSnapshot.data().countOfDocs;
const totalHours: number = aggregateSnapshot.data().totalHours;
const averageScore: number | null = aggregateSnapshot.data().averageScore;

getCount(查詢)

計算指定查詢結果集中的文件數量，但實際上不會下載文件。

使用這個函式計算文件很有效，因為只有最終計數，而非文件。資料，在 Kubernetes 中如果結果集極大 (一千份文件)，這個函式就能計算文件數量。

簽名：

export declare function getCount<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<AggregateQuerySnapshot<{
    count: AggregateField<number>;
}, AppModelType, DbModelType>>;

參數

參數	類型	說明
查詢	查詢<AppModelType、DundModelType>	計算結果集大小的查詢。

傳回：

Promise<AggregateQuerySnapshot<{ count: AggregateField<number>;}、AppModelType、DBMModelType>>

將會用計數解決的承諾；您可以從 snapshot.data().count 擷取計數，其中 snapshot 是傳回 Promise 解析的 AggregateQuerySnapshot。

getDoc(查詢)

執行查詢，並以 QuerySnapshot 形式傳回結果。

所有查詢都是由伺服器直接執行，即使查詢先前已執行也一樣。最近修改過的修改只有在後端已套用的情況下，才會反映在擷取的結果中。如果用戶端處於離線狀態，作業就會失敗。如要查看之前快取的結果和本機修改內容，請使用完整 Firestore SDK。

簽名：

export declare function getDocs<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<QuerySnapshot<AppModelType, DbModelType>>;

參數

參數	類型	說明
查詢	查詢<AppModelType、DundModelType>	要執行的 `Query`。

傳回：

Promise<QuerySnapshot<AppModelType, DBMModelType>>

將與查詢結果解析的 Promise。

query(query, CompositeFilter, queryConstraints)

建立不可變的新 Query 執行個體，擴充為包含其他查詢限制。

簽名：

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, compositeFilter: QueryCompositeFilterConstraint, ...queryConstraints: QueryNonFilterConstraint[]): Query<AppModelType, DbModelType>;

參數

參數	類型	說明
查詢	查詢<AppModelType、DundModelType>	要做為新限制基礎的 Query 執行個體。
複合篩選器	QueryCompositeFilterConstraint	要套用的 QueryCompositeFilterConstraint。使用 and() 或 or() 建立 QueryCompositeFilterConstraint。
queryConstraints	QueryNonFilterConstraint[]	要套用的其他 QueryNonFilterConstraint (例如 orderBy()、limit())。

傳回：

查詢<AppModelType、DundModelType>

例外狀況

，表示其中任一查詢限制無法與現有或新限制合併使用。

query(query, queryConstraints)

建立不可變的新 Query 執行個體，擴充為包含其他查詢限制。

簽名：

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, ...queryConstraints: QueryConstraint[]): Query<AppModelType, DbModelType>;

參數

參數	類型	說明
查詢	查詢<AppModelType、DundModelType>	要做為新限制基礎的 Query 執行個體。
queryConstraints	查詢限制[]	要套用的 QueryConstraint 清單。

傳回：

查詢<AppModelType、DundModelType>

例外狀況

，表示其中任一查詢限制無法與現有或新限制合併使用。

function(queryConstraints, ...)

and(queryConstraints)

建立結合指定篩選器限制的新 QueryCompositeFilterConstraint。如果文件符合所有指定篩選條件，系統就會加入一份文件。

簽名：

export declare function and(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

參數

參數	類型	說明
queryConstraints	QueryFilterConstraint[]	選用設定。要執行連接的 QueryFilterConstraint 清單。建立這些元素時，必須透過呼叫 where()、or() 或 and() 的呼叫建立。

傳回：

新建立的 QueryCompositeFilterConstraint。

or(queryConstraints)

建立新的 QueryCompositeFilterConstraint，為指定篩選器限制條件的分離。解譯篩選器會納入符合任一指定篩選條件的文件。

簽名：

export declare function or(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

參數

參數	類型	說明
queryConstraints	QueryFilterConstraint[]	選用設定。要執行解讀的 QueryFilterConstraint 清單。建立這些元素時，必須透過呼叫 where()、or() 或 and() 的呼叫建立。

傳回：

QueryCompositeFilterConstraint

新建立的 QueryCompositeFilterConstraint。

function(參照, ...)

addDoc(參照, 資料)

使用指定資料在指定的 CollectionReference 中新增文件，自動指派文件 ID。

只有在傳回的承諾產品解決後，寫入作業的結果才會反映在文件讀取作業中。如果用戶端處於離線狀態，寫入就會失敗。如想在用戶端上線前查看本機修改或緩衝區寫入作業，請使用完整 Firestore SDK。

簽名：

export declare function addDoc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<DocumentReference<AppModelType, DbModelType>>;

參數

參數	類型	說明
參考資料	CollectionReference<AppModelType、DundModelType>	要新增這份文件的集合參照。
資料	WithFieldValue<AppModelType>	包含新文件資料的物件。

傳回：

Promise<DocumentReference<AppModelType, DBMModelType>>

Promise 使用 DocumentReference 解析，在文件寫入後端後指向新建立的文件。

例外狀況

錯誤 - 如果提供的輸入內容不是有效的 Firestore 文件，

collection(reference, path, pathSegments)

取得參照指定相對路徑中 reference 子集合的 CollectionReference 例項。

簽名：

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

參數

參數	類型	說明
參考資料	CollectionReference<AppModelType、DundModelType>	集合的參照。
路徑	字串	以斜線分隔的路徑，指向集合。
路徑區隔	string[]	相對於第一個引數要套用的其他路徑區段。

傳回：

CollectionReference<DocumentData、DocumentData>

CollectionReference 例項。

例外狀況

如果最終路徑的線段數為偶數，且並不指向集合，

collection(reference, path, pathSegments)

取得參照指定相對路徑中 reference 子集合的 CollectionReference 例項。

簽名：

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	Firestore 文件的參照。
路徑	字串	以斜線分隔的路徑，指向集合。
路徑區隔	string[]	將根據第一個引數套用的其他路徑區段。

傳回：

CollectionReference<DocumentData、DocumentData>

CollectionReference 例項。

例外狀況

如果最終路徑的線段數為偶數，且並不指向集合，

deleteDoc(參照)

刪除指定 DocumentReference 參照的文件。

只有在傳回的承諾產品解決後，系統才會在文件讀取作業中反映刪除作業。如果用戶端處於離線狀態，刪除作業就會失敗。如想在用戶端上線前查看本機修改或緩衝區寫入作業，請使用完整 Firestore SDK。

簽名：

export declare function deleteDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<void>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要刪除的文件參照。

傳回：

Promise<void>

成功從後端刪除文件後，Promise 已解決。

doc(reference, path, pathSegments)

取得參照指定相對路徑 reference 中文件的 DocumentReference 例項。如未指定路徑，系統會為傳回的 DocumentReference 使用自動產生的專屬 ID。

簽名：

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path?: string, ...pathSegments: string[]): DocumentReference<AppModelType, DbModelType>;

參數

參數	類型	說明
參考資料	CollectionReference<AppModelType、DundModelType>	集合的參照。
路徑	字串	文件的斜線分隔路徑。如要使用自動產生的 ID，請省略。
路徑區隔	string[]	將根據第一個引數套用的其他路徑區段。

傳回：

DocumentReference<AppModelType、DundModelType>

DocumentReference 例項。

例外狀況

如果最後一個路徑的路段數量奇怪，且未指向文件，

doc(reference, path, pathSegments)

取得參照指定相對路徑 reference 中文件的 DocumentReference 例項。

簽名：

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	Firestore 文件的參照。
路徑	字串	文件的斜線分隔路徑。
路徑區隔	string[]	將根據第一個引數套用的其他路徑區段。

傳回：

DocumentReference<DocumentData、DocumentData>

DocumentReference 例項。

例外狀況

如果最後一個路徑的路段數量奇怪，且未指向文件，

getDoc(參照)

這個外掛程式能讀取指定文件參照所參照的文件。

所有文件都會直接從伺服器擷取，即使文件先前已讀取或修改過也一樣。最近修改過的修改只有在後端已套用的情況下，才會反映在擷取的 DocumentSnapshot 中。如果用戶端處於離線狀態，讀取作業就會失敗。如要使用快取或查看本機修改內容，請使用完整 Firestore SDK。

簽名：

export declare function getDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<DocumentSnapshot<AppModelType, DbModelType>>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要擷取的文件參照。

傳回：

Promise<DocumentSnapshot<AppModelType, DBMModelType>>

Promise 已透過包含目前文件內容的 DocumentSnapshot 解析。

setDoc(參照, 資料)

寫入指定 DocumentReference 所參照的文件。如果文件不存在，系統會建立文件。

簽名：

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<void>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要寫入的文件參照。
資料	WithFieldValue<AppModelType>	文件的欄位和值的對應。

傳回：

Promise<void>

一旦資料成功寫入後端，Promise 就會解析。

例外狀況

錯誤 - 如果提供的輸入內容不是有效的 Firestore 文件，

setDoc(參照, 資料, 選項)

寫入指定 DocumentReference 所參照的文件。如果文件不存在，系統會建立文件。如果您提供 merge 或 mergeFields，所提供的資料可以合併為現有文件。

簽名：

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: PartialWithFieldValue<AppModelType>, options: SetOptions): Promise<void>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要寫入的文件參照。
資料	PartialWithFieldValue<AppModelType>	文件的欄位和值的對應。
選項	設定選項	用來設定設定行為的物件。

傳回：

Promise<void>

一旦資料成功寫入後端，Promise 就會解析。

例外狀況

錯誤 - 如果提供的輸入內容不是有效的 Firestore 文件，

updateDoc(參照, 資料)

更新指定 DocumentReference 所參照文件中的欄位。如果套用至不存在的文件，更新就會失敗。

只有在傳回的承諾產品解決後，這項更新的結果才會反映在文件讀取作業中。如果用戶端處於離線狀態，更新就會失敗。如想在用戶端上線前查看本機修改或緩衝區寫入作業，請使用完整 Firestore SDK。

簽名：

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: UpdateData<DbModelType>): Promise<void>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要更新文件的參照。
資料	UpdateData<DbModelType>	物件，內容包含要更新文件的欄位和值。欄位可以包含半形句號，以參照文件中的巢狀欄位。

傳回：

Promise<void>

一旦資料成功寫入後端，Promise 就會解析。

例外狀況

錯誤 - 如果提供的輸入內容不是有效的 Firestore 資料，

updateDoc(reference, 欄位, 值, moreFieldsAndValues)

更新指定 DocumentReference 所參照文件中的欄位，如果套用至不存在的文件，更新作業就會失敗。

透過提供以點分隔的欄位路徑字串或 FieldPath 物件，即可更新巢狀欄位。

簽名：

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, field: string | FieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Promise<void>;

參數

參數	類型	說明
參考資料	DocumentReference<AppModelType、DundModelType>	要更新文件的參照。
欄位	字串 \|FieldPath	要更新的第一個欄位。
值	不明	第一個值。
moreFieldsAndValues	不明 []	其他鍵/值組合。

傳回：

Promise<void>

一旦資料成功寫入後端，Promise 就會解析。

例外狀況

錯誤 - 如果提供的輸入內容不是有效的 Firestore 資料，

function(快照, ...)

endAt(快照)

建立 QueryEndAtConstraint，將結果集修改至提供的文件 (包含)。結束位置與查詢的順序相關。文件必須包含查詢的 orderBy 中所提供的所有欄位。

簽名：

export declare function endAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

參數

參數	類型	說明
快照	DocumentSnapshot<AppModelType、DundModelType>	結尾文件的快照。

傳回：

要傳遞至 query() 的 QueryEndAtConstraint

endBefore(快照)

建立 QueryEndAtConstraint，將結果集修改為在提供的文件前結束 (不含)。結束位置與查詢的順序相關。文件必須包含查詢的 orderBy 中所提供的所有欄位。

簽名：

export declare function endBefore<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

參數

參數	類型	說明
快照	DocumentSnapshot<AppModelType、DundModelType>	文件的結束日期。

傳回：

要傳遞至 query() 的 QueryEndAtConstraint

startAfter(快照)

建立 QueryStartAtConstraint，藉此修改結果集在提供的文件後方開頭 (不含)。起始位置與查詢順序相關。文件必須包含查詢的 orderBy 中所提供的所有欄位。

簽名：

export declare function startAfter<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

參數

參數	類型	說明
快照	DocumentSnapshot<AppModelType、DundModelType>	文件的開始日期。

傳回：

要傳遞至 query() 的 QueryStartAtConstraint

startAt(快照)

建立 QueryStartAtConstraint，以將結果集修改為在提供的文件 (包含) 上。起始位置與查詢順序相關。文件必須包含這項查詢的 orderBy 中提供的所有欄位。

簽名：

export declare function startAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

參數

參數	類型	說明
快照	DocumentSnapshot<AppModelType、DundModelType>	文件的快照畫面。

傳回：