@firebase/firestore/lite

Bản sao Firestore của ứng dụng đã cung cấp.

getFirestore(ứng dụng, Cơ sở dữ liệuId)

API này được cung cấp dưới dạng bản xem trước cho các nhà phát triển và có thể thay đổi dựa trên phản hồi mà chúng tôi nhận được. Không sử dụng API này trong môi trường phát hành chính thức.

Trả về thực thể Firestore hiện có liên kết với FirebaseApp được cung cấp. Nếu không có thực thể nào tồn tại, hãy khởi chạy một phiên bản mới với chế độ cài đặt mặc định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ứng dụng	Ứng dụng Firebase	Phiên bản FirebaseApp mà phiên bản Firestore đã trả về được liên kết.
mã cơ sở dữ liệu	chuỗi	Tên của cơ sở dữ liệu.

Trường hợp trả lại hàng:

Bản sao Firestore của ứng dụng đã cung cấp.

khởi độngFirestore(ứng dụng, chế độ cài đặt)

Khởi chạy một thực thể mới của Cloud Firestore với các chế độ cài đặt được cung cấp. Chỉ có thể được gọi trước các hàm khác, bao gồm cả getFirestore(). Nếu chế độ cài đặt tuỳ chỉnh trống, thì hàm này tương đương với việc gọi getFirestore().

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ứng dụng	Ứng dụng Firebase	FirebaseApp mà thực thể `Firestore` sẽ được liên kết.
cài đặt	Cài đặt	Đối tượng cài đặt để định cấu hình thực thể `Firestore`.

Trường hợp trả lại hàng:

Một thực thể Firestore mới khởi tạo.

derivedFirestore(ứng dụng, chế độ cài đặt, DatabaseId)

API này được cung cấp dưới dạng bản xem trước cho các nhà phát triển và có thể thay đổi dựa trên phản hồi mà chúng tôi nhận được. Không sử dụng API này trong môi trường phát hành chính thức.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ứng dụng	Ứng dụng Firebase	FirebaseApp mà thực thể `Firestore` sẽ được liên kết.
cài đặt	Cài đặt	Đối tượng cài đặt để định cấu hình thực thể `Firestore`.
mã cơ sở dữ liệu	chuỗi	Tên của cơ sở dữ liệu.

Trường hợp trả lại hàng:

CollectionReference<DocumentData, DocumentData>

Một thực thể Firestore mới khởi tạo.

function(firestore, ...)

bộ sưu tập(kho lửa, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể CollectionReference tham chiếu đến tập hợp tại đường dẫn tuyệt đối được chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Tham chiếu đến thực thể gốc `Firestore`.
đường dẫn	chuỗi	Đường dẫn đến một bộ sưu tập được phân tách bằng dấu gạch chéo.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung cần áp dụng liên quan đến đối số đầu tiên.

Trường hợp trả lại hàng:

Thực thể CollectionReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số lượng phân đoạn bằng nhau và không trỏ đến một tập hợp.

collectionGroup(firestore, collectionId)

Tạo và trả về một thực thể Query mới bao gồm tất cả tài liệu trong cơ sở dữ liệu có trong một tập hợp hoặc bộ sưu tập con có collectionId đã cho.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Tham chiếu đến thực thể gốc `Firestore`.
mã bộ sưu tập	chuỗi	Xác định các tập hợp để truy vấn. Mọi bộ sưu tập hoặc bộ sưu tập con có mã nhận dạng này ở phân đoạn cuối cùng của đường dẫn sẽ được đưa vào. Không được chứa dấu gạch chéo.

Trường hợp trả lại hàng:

Truy vấn<DocumentData, DocumentData>

Query đã được tạo.

connectFirestoreEmulator(firestore, máy chủ, cổng, tuỳ chọn)

Sửa đổi phiên bản này để giao tiếp với trình mô phỏng Cloud Firestore.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Thực thể `Firestore` để định cấu hình kết nối với trình mô phỏng.
máy chủ lưu trữ	chuỗi	máy chủ lưu trữ trình mô phỏng (ví dụ: localhost).
cổng	số	cổng trình mô phỏng (ví dụ: 9000).
tuỳ chọn	{ mockUserToken?: EmulatorMockTokenOptions \| chuỗi; }

Trường hợp trả lại hàng:

trống

tài liệu(kho lửa, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể DocumentReference tham chiếu đến tài liệu tại đường dẫn tuyệt đối đã chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Tham chiếu đến thực thể gốc `Firestore`.
đường dẫn	chuỗi	Đường dẫn đến một tài liệu được phân tách bằng dấu gạch chéo.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung sẽ được áp dụng tương ứng với đối số đầu tiên.

Trường hợp trả lại hàng:

DocumentReference<DocumentData, documentData>

Thực thể DocumentReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số đoạn lẻ và không trỏ đến tài liệu.

runTransaction(firestore; updateFunction; các tuỳ chọn)

Thực thi updateFunction đã cho và sau đó cố gắng xác nhận các thay đổi được áp dụng trong giao dịch. Nếu bất kỳ tài liệu nào được đọc trong giao dịch đã thay đổi, Cloud Firestore sẽ thử lại updateFunction. Nếu không thực hiện được sau 5 lần thử, thì giao dịch sẽ không thành công.

Số lượt ghi tối đa được phép trong một giao dịch là 500.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Mã tham chiếu đến cơ sở dữ liệu Firestore để chạy giao dịch này.
cập nhậtHàm	(giao dịch: Giao dịch) => Cam kết<T>	Hàm thực thi trong ngữ cảnh giao dịch.
tuỳ chọn	Giao dịch	Đối tượng tuỳ chọn để định cấu hình số lần cam kết tối đa.

Trường hợp trả lại hàng:

Cam kết<T>

Nếu giao dịch đã hoàn tất thành công hoặc bị huỷ một cách rõ ràng (updateFunction trả về một hứa hẹn không thành công), thì lời hứa mà updateFunctiontrả về sẽ được trả về ở đây. Ngược lại, nếu giao dịch không thành công, hệ thống sẽ trả về lời hứa bị từ chối kèm theo lỗi không thành công tương ứng.

chấm dứt(cửa hàng lửa)

Chấm dứt thực thể Firestore được cung cấp.

Sau khi gọi terminate(), bạn chỉ có thể sử dụng các hàm clearIndexedDbPersistence(). Mọi hàm khác sẽ gửi một FirestoreError. Việc chấm dứt không huỷ bỏ bất kỳ lệnh ghi đang chờ xử lý nào và mọi lời hứa đang chờ phản hồi từ máy chủ sẽ không được giải quyết.

Để khởi động lại sau khi chấm dứt, hãy tạo một thực thể mới của Firestore bằng getFirestore().

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục	Thực thể `Firestore` cần chấm dứt.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise được phân giải khi thực thể đã kết thúc thành công.

ghi lô(firestore)

Tạo một lô ghi, dùng để thực hiện nhiều lần ghi dưới dạng một thao tác ở cấp nguyên tử. Số lần ghi tối đa được phép trong một WriteBatch là 500.

Kết quả của những lần ghi này sẽ chỉ được phản ánh trong các lần đọc tài liệu xảy ra sau khi phân giải hàm hứa được trả về. Nếu ứng dụng không có kết nối mạng, thì quá trình ghi sẽ không thành công. Nếu bạn muốn xem nội dung sửa đổi cục bộ hoặc ghi vùng đệm cho đến khi ứng dụng có kết nối mạng, hãy sử dụng toàn bộ SDK Firestore.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
kho cứu hoả	Khôi phục

Trường hợp trả lại hàng:

WriteBatch

WriteBatch có thể dùng để thực thi nhiều lượt ghi ở dạng nguyên tử.

Hàm()

số đếm()

Tạo một đối tượng AggregateField có thể dùng để tính số lượng tài liệu trong tập hợp kết quả của một truy vấn.

Chữ ký:

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

Trường hợp trả lại hàng:

AggregateField<number>

deleteField()

Trả về một người gửi để sử dụng với updateDoc() hoặc setDoc() với {merge: true} nhằm đánh dấu một trường cần xoá.

Chữ ký:

export declare function deleteField(): FieldValue;

Trường hợp trả lại hàng:

documentId()

Trả về một giám sát đặc biệt FieldPath để tham chiếu đến mã nhận dạng của một tài liệu. Có thể dùng tên này trong các truy vấn để sắp xếp hoặc lọc theo mã tài liệu.

Chữ ký:

export declare function documentId(): FieldPath;

Trường hợp trả lại hàng:

FieldPath (Đường dẫn trường)

getFirestore()

Trả về phiên bản Firestore mặc định hiện có được liên kết với FirebaseApp mặc định. Nếu không có thực thể nào tồn tại, hãy khởi chạy một phiên bản mới với chế độ cài đặt mặc định.

Chữ ký:

export declare function getFirestore(): Firestore;

Trường hợp trả lại hàng:

Bản sao Firestore của ứng dụng đã cung cấp.

máy chủDấu thời gian()

Trả về một người gửi dùng với setDoc() hoặc updateDoc() để đưa dấu thời gian do máy chủ tạo vào dữ liệu đã ghi.

Chữ ký:

export declare function serverTimestamp(): FieldValue;

Trường hợp trả lại hàng:

function(databaseId, ...)

getFirestore(databaseId)

API này được cung cấp dưới dạng bản xem trước cho các nhà phát triển và có thể thay đổi dựa trên phản hồi mà chúng tôi nhận được. Không sử dụng API này trong môi trường phát hành chính thức.

Trả về thực thể Firestore hiện có được liên kết với FirebaseApp mặc định. Nếu không có thực thể nào tồn tại, hãy khởi chạy một phiên bản mới với chế độ cài đặt mặc định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
mã cơ sở dữ liệu	chuỗi	Tên của cơ sở dữ liệu.

Trường hợp trả lại hàng:

Bản sao Firestore của ứng dụng đã cung cấp.

hàm(phần tử, ...)

mảngRemove(phần tử)

Trả về một giá trị đặc biệt có thể dùng với setDoc() hoặc yêu cầu máy chủ xoá các phần tử đã cho khỏi bất kỳ giá trị mảng nào đã tồn tại trên máy chủ. Tất cả các bản sao của từng phần tử được chỉ định sẽ bị xóa khỏi mảng. Nếu trường đang được sửa đổi không phải là một mảng, thì trường đó sẽ bị ghi đè bằng một mảng trống.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
phần tử	không xác định[]	Các phần tử cần xoá khỏi mảng.

Trường hợp trả lại hàng:

Gửi yêu cầu FieldValue để dùng trong lệnh gọi đến setDoc() hoặc updateDoc()

mảngUnion(phần tử)

Trả về một giá trị đặc biệt có thể dùng với setDoc() hoặc updateDoc(). Giá trị này yêu cầu máy chủ hợp nhất các phần tử đã cho với bất kỳ giá trị mảng nào đã tồn tại trên máy chủ. Mỗi phần tử được chỉ định chưa tồn tại trong mảng sẽ được thêm vào cuối. Nếu trường đang được sửa đổi không phải là một mảng thì trường đó sẽ bị ghi đè bằng một mảng chứa chính xác các phần tử được chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
phần tử	không xác định[]	Các phần tử cần hợp nhất thành mảng.

Trường hợp trả lại hàng:

QueryFieldFilterConstraint

Gửi yêu cầu FieldValue để dùng trong lệnh gọi đến setDoc() hoặc updateDoc().

function(trường, ...)

trung bình(trường)

Tạo một đối tượng AggregateField có thể dùng để tính giá trị trung bình của một trường đã chỉ định trên một dải tài liệu trong tập hợp kết quả của một truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trường	chuỗi \| FieldPath (Đường dẫn trường)	Chỉ định trường để tính giá trị trung bình của tập hợp kết quả.

Trường hợp trả lại hàng:

AggregateField<number | rỗng>

sum(trường)

Tạo một đối tượng AggregateField có thể dùng để tính tổng của một trường chỉ định trên một dải tài liệu trong tập hợp kết quả của một truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trường	chuỗi \| FieldPath (Đường dẫn trường)	Chỉ định trường để tính tổng qua tập hợp kết quả.

Trường hợp trả lại hàng:

AggregateField<number>

function(fieldPath, ...)

orderBy(fieldPath, directionStr)

Tạo một QueryOrderByConstraint để sắp xếp kết quả truy vấn theo trường được chỉ định, không bắt buộc theo thứ tự giảm dần thay vì tăng dần.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
Đường dẫn trường	chuỗi \| FieldPath (Đường dẫn trường)	Trường để sắp xếp theo.
Chỉ đường	OrderByDirection	Hướng không bắt buộc để sắp xếp theo ("theo thứ tự tăng dần" hoặc "theo thứ tự giảm dần"). Nếu bạn không chỉ định, thứ tự sẽ tăng dần.

Trường hợp trả lại hàng:

QueryOrderByConstraint

QueryOrderByConstraint đã tạo.

where(fieldPath; opStr; giá trị)

Tạo một QueryFieldFilterConstraint để thực thi các tài liệu phải chứa trường được chỉ định và giá trị phải đáp ứng quy tắc ràng buộc mối quan hệ đã cung cấp.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
Đường dẫn trường	chuỗi \| FieldPath (Đường dẫn trường)	Lộ trình so sánh
hoạt động	WhereFilterOp	Chuỗi thao tác (ví dụ: "<", "<=", "==", "<", "<=", "!=").
value	không xác định	Giá trị để so sánh

Trường hợp trả lại hàng:

QueryFieldFilterConstraint đã tạo.

function(fieldValues, ...)

endAt(fieldValues)

Tạo một QueryEndAtConstraint để sửa đổi kết quả được đặt thành kết thúc tại các trường đã cung cấp tương ứng với thứ tự của truy vấn. Thứ tự của các giá trị trường phải khớp với thứ tự của thứ tự theo mệnh đề của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giá trị trường	không xác định[]	Các giá trị trường để kết thúc truy vấn này theo thứ tự của truy vấn.

Trường hợp trả lại hàng:

QueryEndAtConstraint để truyền đến query()

endbefore(giá trị trường)

Tạo một QueryEndAtConstraint để sửa đổi tập hợp kết quả thành kết thúc trước khi các trường được cung cấp tương ứng với thứ tự của truy vấn. Thứ tự của các giá trị trường phải khớp với thứ tự của thứ tự theo mệnh đề của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giá trị trường	không xác định[]	Các giá trị trường để kết thúc truy vấn này trước, theo thứ tự của truy vấn.

Trường hợp trả lại hàng:

QueryEndAtConstraint để truyền đến query()

startSau(Giá trị trường)

Tạo một QueryStartAtConstraint để sửa đổi tập hợp kết quả để bắt đầu sau các trường đã cung cấp tương ứng với thứ tự của truy vấn. Thứ tự của các giá trị trường phải khớp với thứ tự của thứ tự theo mệnh đề của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giá trị trường	không xác định[]	Các giá trị trường để bắt đầu truy vấn này sau đó, theo thứ tự của truy vấn.

Trường hợp trả lại hàng:

QueryStartAtConstraint để truyền đến query()

startAt(giá trị trường)

Tạo một QueryStartAtConstraint để sửa đổi tập hợp kết quả để bắt đầu tại các trường đã cung cấp tương ứng với thứ tự của truy vấn. Thứ tự của các giá trị trường phải khớp với thứ tự của thứ tự theo mệnh đề của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giá trị trường	không xác định[]	Các giá trị trường để bắt đầu truy vấn này theo thứ tự của truy vấn.

Trường hợp trả lại hàng:

QueryStartAtConstraint để truyền đến query().

hàm(trái, ...)

totalFieldEqual(trái, phải)

So sánh hai thực thể "AggregateField" để xét đẳng thức.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trái	AggregateField<không xác định>	So sánh AggregateField này với `right`.
phải	AggregateField<không xác định>	So sánh AggregateField này với `left`.

Trường hợp trả lại hàng:

boolean

tổng hợpQuerySnapshotEqual(trái, phải)

So sánh 2 thực thể AggregateQuerySnapshot để xem có đẳng thức.

2 thực thể AggregateQuerySnapshot được coi là "bằng" nếu chúng có các truy vấn cơ bản so sánh bằng nhau và cùng dữ liệu.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trái	AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>	`AggregateQuerySnapshot` đầu tiên để so sánh.
phải	AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>	`AggregateQuerySnapshot` thứ hai cần so sánh.

Trường hợp trả lại hàng:

boolean

true nếu các đối tượng "bằng", như định nghĩa ở trên hoặc false nếu không.

queryEqual(trái, phải)

Trả về true nếu các truy vấn đã cho trỏ đến cùng một tập hợp và áp dụng các điều kiện ràng buộc tương tự.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trái	Truy vấn<AppModelType, DbModelType>	`Query` để so sánh.
phải	Truy vấn<AppModelType, DbModelType>	`Query` để so sánh.

Trường hợp trả lại hàng:

boolean

true nếu các tham chiếu trỏ đến cùng một vị trí trong cùng một cơ sở dữ liệu Firestore.

refEqual(trái; phải)

Trả về true nếu các giá trị tham chiếu đã cho bằng nhau.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trái	DocumentReference<AppModelType, DbModelType> \| CollectionReference<AppModelType, DbModelType>	Một tài liệu tham khảo để so sánh.
phải	DocumentReference<AppModelType, DbModelType> \| CollectionReference<AppModelType, DbModelType>	Một tài liệu tham khảo để so sánh.

Trường hợp trả lại hàng:

boolean

true nếu các tham chiếu trỏ đến cùng một vị trí trong cùng một cơ sở dữ liệu Firestore.

snapshotEqual(trái, phải)

Trả về true nếu các ảnh chụp nhanh được cung cấp bằng nhau.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
trái	DocumentSnapshot<AppModelType, DbModelType> \| QuerySnapshot<AppModelType, DbModelType>	Thông tin tổng quan nhanh để so sánh.
phải	DocumentSnapshot<AppModelType, DbModelType> \| QuerySnapshot<AppModelType, DbModelType>	Thông tin tổng quan nhanh để so sánh.

Trường hợp trả lại hàng:

boolean

true nếu các ảnh chụp nhanh bằng nhau.

hàm(giới hạn, ...)

giới hạn(giới hạn)

Tạo một QueryLimitConstraint chỉ trả về những tài liệu phù hợp đầu tiên.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giới hạn	số	Số lượng mục tối đa cần trả về.

Trường hợp trả lại hàng:

QueryLimitConstraint

QueryLimitConstraint đã tạo.

limitToLast(giới hạn)

Tạo một QueryLimitConstraint chỉ trả về những tài liệu khớp gần đây nhất.

Bạn phải chỉ định ít nhất một mệnh đề orderBy cho các truy vấn limitToLast, nếu không, hệ thống sẽ gửi một ngoại lệ trong quá trình thực thi.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
giới hạn	số	Số lượng mục tối đa cần trả về.

Trường hợp trả lại hàng:

QueryLimitConstraint

QueryLimitConstraint đã tạo.

hàm(loglevel, ...)

setLogLevel(logLevel)

Đặt độ chi tiết của nhật ký Cloud Firestore (gỡ lỗi, lỗi hoặc im lặng).

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
cấp độ nhật ký	Cấp độ nhật ký	Độ chi tiết mà bạn đặt để ghi nhật ký hoạt động và lỗi. Có thể là bất kỳ giá trị nào sau đây: `debug` cho cấp độ ghi nhật ký chi tiết nhất, chủ yếu cho mục đích gỡ lỗi. `error` để chỉ ghi lại lỗi. `silent to turn off logging.`

Trường hợp trả lại hàng:

trống

function(n, ...)

tăng dần(n)

Trả về một giá trị đặc biệt có thể dùng với setDoc() hoặc updateDoc(). Giá trị này yêu cầu máy chủ tăng giá trị hiện tại của trường theo giá trị đã cho.

Nếu toán hạng hoặc giá trị trường hiện tại sử dụng độ chính xác dấu phẩy động, thì tất cả số học đều tuân theo ngữ nghĩa của IEEE 754. Nếu cả hai giá trị đều là số nguyên, thì các giá trị nằm ngoài phạm vi số an toàn của JavaScript (Number.MIN_SAFE_INTEGER đến Number.MAX_SAFE_INTEGER) cũng bị mất độ chính xác. Hơn nữa, sau khi được xử lý bởi phần phụ trợ Firestore, tất cả các thao tác số nguyên đều được giới hạn trong khoảng từ -2^63 đến 2^63-1.

Nếu giá trị trường hiện tại không thuộc loại number hoặc nếu trường chưa tồn tại, quy tắc chuyển đổi sẽ đặt trường thành giá trị đã cho.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
n	số	Giá trị cần tăng theo.

Trường hợp trả lại hàng:

QueryCompositeFilterConstraint

Gửi yêu cầu FieldValue để dùng trong lệnh gọi đến setDoc() hoặc updateDoc()

function(truy vấn, ...)

getAggregate(query, totalSpec)

Tính toán các dữ liệu tổng hợp được chỉ định trên các tài liệu trong tập hợp kết quả của truy vấn cho trước mà không cần tải tài liệu xuống.

Việc sử dụng hàm này để thực hiện tổng hợp là một cách hiệu quả vì chỉ có các giá trị tổng hợp cuối cùng chứ không phải tài liệu' đã được tải xuống. Hàm này có thể tổng hợp tài liệu trong trường hợp tập hợp kết quả quá lớn để tải xuống hoàn toàn (hàng nghìn tài liệu).

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
truy vấn	Truy vấn<AppModelType, DbModelType>	Truy vấn có nhóm kết quả được tổng hợp.
Thông số kỹ thuật tổng hợp	AggregateSpecType	Đối tượng `AggregateSpec` chỉ định các tổng hợp để thực hiện trên tập hợp kết quả. AggregateSpec chỉ định bí danh cho mỗi dữ liệu tổng hợp, có thể dùng để truy xuất kết quả tổng hợp.

Trường hợp trả lại hàng:

Cam kết<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>>

Ví dụ

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(truy vấn)

Tính toán số lượng tài liệu trong tập hợp kết quả của truy vấn đã cho mà không thực sự tải tài liệu xuống.

Việc sử dụng hàm này để đếm tài liệu là hiệu quả vì chỉ số lượng cuối cùng chứ không phải tài liệu' đã được tải xuống. Hàm này có thể đếm tài liệu trong trường hợp tập hợp kết quả quá lớn để tải xuống toàn bộ (hàng nghìn tài liệu).

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
truy vấn	Truy vấn<AppModelType, DbModelType>	Truy vấn có kích thước nhóm kết quả được tính toán.

Trường hợp trả lại hàng:

Hứa hẹn<AggregateQuerySnapshot<{ count: AggregateField<number>; }, AppModelType, DbModelType>>

Lời hứa sẽ được giải quyết với số lượng; số lượng này có thể được truy xuất từ snapshot.data().count, trong đó snapshot là AggregateQuerySnapshot mà Lời hứa được trả về phân giải đến.

getDocuments(truy vấn)

Thực thi truy vấn và trả về kết quả dưới dạng QuerySnapshot.

Tất cả truy vấn đều được máy chủ thực thi trực tiếp, ngay cả khi truy vấn đã được thực thi trước đó. Nội dung sửa đổi gần đây chỉ được phản ánh trong kết quả đã truy xuất nếu chương trình phụ trợ đã áp dụng các nội dung sửa đổi đó. Nếu ứng dụng không có kết nối mạng, thì thao tác sẽ không thành công. Để xem kết quả được lưu vào bộ nhớ đệm trước đó và các nội dung sửa đổi cục bộ, hãy sử dụng SDK Firestore đầy đủ.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
truy vấn	Truy vấn<AppModelType, DbModelType>	`Query` để thực thi.

Trường hợp trả lại hàng:

Cam kết<QuerySnapshot<AppModelType, DbModelType>>

Lời hứa sẽ được giải quyết bằng kết quả của truy vấn.

truy vấn(query, compositeFilter, queryConstraints)

Tạo một thực thể Truy vấn bất biến mới và được mở rộng để bao gồm cả các điều kiện ràng buộc khác đối với truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
truy vấn	Truy vấn<AppModelType, DbModelType>	Thực thể Query để dùng làm cơ sở cho các quy tắc ràng buộc mới.
bộ lọc tổng hợp	QueryCompositeFilterConstraint	QueryCompositeFilterConstraint sẽ được áp dụng. Tạo QueryCompositeFilterConstraint bằng cách sử dụng and() hoặc or().
queryConstraints	QueryNonFilterConstraint[]	Các QueryNonFilterConstraint bổ sung cần áp dụng (ví dụ: orderBy(), limit()).

Trường hợp trả lại hàng:

Truy vấn<AppModelType, DbModelType>

Trường hợp ngoại lệ

nếu không thể kết hợp bất kỳ quy tắc ràng buộc nào đối với truy vấn đã cho với quy tắc ràng buộc hiện tại hoặc mới.

truy vấn(query, queryConstraints)

Tạo một thực thể Truy vấn bất biến mới và được mở rộng để bao gồm cả các điều kiện ràng buộc khác đối với truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
truy vấn	Truy vấn<AppModelType, DbModelType>	Thực thể Query để dùng làm cơ sở cho các quy tắc ràng buộc mới.
queryConstraints	QueryConstraint[]	Danh sách QueryConstraints để áp dụng.

Trường hợp trả lại hàng:

Truy vấn<AppModelType, DbModelType>

Trường hợp ngoại lệ

nếu không thể kết hợp bất kỳ quy tắc ràng buộc nào đối với truy vấn đã cho với quy tắc ràng buộc hiện tại hoặc mới.

function(queryConstraints, ...)

và(queryConstraints)

Tạo một QueryCompositeFilterConstraint mới là sự kết hợp của các giới hạn bộ lọc nhất định. Một bộ lọc nối bao gồm một tài liệu nếu tài liệu đó đáp ứng tất cả các bộ lọc đã cho.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
queryConstraints	QueryFilterConstraint[]	Không bắt buộc. Danh sách QueryFilterConstraint để thực hiện việc liên kết. Các toán tử này phải được tạo bằng các lệnh gọi đến where(), or() hoặc and().

Trường hợp trả lại hàng:

QueryCompositeFilterConstraint mới được tạo.

hoặc(queryConstraints)

Tạo một QueryCompositeFilterConstraint mới là sự tách biệt của các hạn chế đối với bộ lọc nhất định. Bộ lọc phân tách bao gồm một tài liệu nếu tài liệu đó đáp ứng bất kỳ bộ lọc nào trong số các bộ lọc đã cho.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
queryConstraints	QueryFilterConstraint[]	Không bắt buộc. Danh sách QueryFilterConstraint để thực hiện tách biệt. Các toán tử này phải được tạo bằng các lệnh gọi đến where(), or() hoặc and().

Trường hợp trả lại hàng:

QueryCompositeFilterConstraint

QueryCompositeFilterConstraint mới được tạo.

hàm(tham chiếu, ...)

addDoc(tài liệu tham khảo, dữ liệu)

Thêm một tài liệu mới vào CollectionReference được chỉ định bằng dữ liệu đã cho, tự động gán mã tài liệu cho tài liệu đó.

Kết quả của lần ghi này sẽ chỉ được phản ánh trong các lần đọc tài liệu xảy ra sau khi phân giải hàm hứa được trả về. Nếu ứng dụng không có kết nối mạng, thì quá trình ghi sẽ không thành công. Nếu bạn muốn xem nội dung sửa đổi cục bộ hoặc ghi vùng đệm cho đến khi ứng dụng có kết nối mạng, hãy sử dụng toàn bộ SDK Firestore.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	CollectionReference<AppModelType, DbModelType>	Tham chiếu đến bộ sưu tập để thêm tài liệu này vào.
dữ liệu	WithFieldValue<AppModelType>	Đối tượng chứa dữ liệu của tài liệu mới.

Trường hợp trả lại hàng:

Cam kết<DocumentReference<AppModelType, DbModelType>>

Promise được giải quyết bằng DocumentReference trỏ đến tài liệu mới tạo sau khi tài liệu đó được ghi vào phần phụ trợ.

Trường hợp ngoại lệ

Lỗi – Nếu thông tin đầu vào mà bạn cung cấp không phải là tài liệu hợp lệ trên Firestore.

bộ sưu tập(tham chiếu, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể CollectionReference tham chiếu đến một bộ sưu tập con reference tại đường dẫn tương đối được chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	CollectionReference<AppModelType, DbModelType>	Tham chiếu đến một bộ sưu tập.
đường dẫn	chuỗi	Đường dẫn đến một bộ sưu tập được phân tách bằng dấu gạch chéo.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung cần áp dụng liên quan đến đối số đầu tiên.

Trường hợp trả lại hàng:

CollectionReference<DocumentData, DocumentData>

Thực thể CollectionReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số lượng phân đoạn bằng nhau và không trỏ đến một tập hợp.

bộ sưu tập(tham chiếu, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể CollectionReference tham chiếu đến một bộ sưu tập con reference tại đường dẫn tương đối được chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu trên Firestore.
đường dẫn	chuỗi	Đường dẫn đến một bộ sưu tập được phân tách bằng dấu gạch chéo.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung sẽ được áp dụng tương ứng với đối số đầu tiên.

Trường hợp trả lại hàng:

CollectionReference<DocumentData, DocumentData>

Thực thể CollectionReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số lượng phân đoạn bằng nhau và không trỏ đến một tập hợp.

deleteDoc(tài liệu tham khảo)

Xoá tài liệu được tham chiếu bởi DocumentReference được chỉ định.

Thao tác xoá sẽ chỉ được phản ánh trong các lượt đọc tài liệu diễn ra sau khi phân giải lời hứa được trả về. Nếu ứng dụng không có kết nối mạng, thì thao tác xoá sẽ không thành công. Nếu bạn muốn xem nội dung sửa đổi cục bộ hoặc ghi vùng đệm cho đến khi ứng dụng có kết nối mạng, hãy sử dụng toàn bộ SDK Firestore.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu cần xoá.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise đã được phân giải sau khi xoá thành công tài liệu khỏi phần phụ trợ.

tài liệu(tham chiếu, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể DocumentReference tham chiếu đến một tài liệu trong reference tại đường dẫn tương đối được chỉ định. Nếu bạn không chỉ định đường dẫn, thì hệ thống sẽ dùng một mã nhận dạng duy nhất được tạo tự động cho DocumentReference được trả về.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	CollectionReference<AppModelType, DbModelType>	Tham chiếu đến một bộ sưu tập.
đường dẫn	chuỗi	Đường dẫn đến một tài liệu được phân tách bằng dấu gạch chéo. Phải được bỏ qua để sử dụng mã nhận dạng được tạo tự động.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung sẽ được áp dụng tương ứng với đối số đầu tiên.

Trường hợp trả lại hàng:

DocumentReference<AppModelType, DbModelType>

Thực thể DocumentReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số đoạn lẻ và không trỏ đến tài liệu.

tài liệu(tham chiếu, đường dẫn, đường dẫn phân đoạn)

Lấy một thực thể DocumentReference tham chiếu đến một tài liệu trong reference tại đường dẫn tương đối được chỉ định.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu trên Firestore.
đường dẫn	chuỗi	Đường dẫn đến một tài liệu được phân tách bằng dấu gạch chéo.
path Segment (Phân đoạn đường dẫn)	chuỗi[]	Các phân đoạn đường dẫn bổ sung sẽ được áp dụng tương ứng với đối số đầu tiên.

Trường hợp trả lại hàng:

DocumentReference<DocumentData, documentData>

Thực thể DocumentReference.

Trường hợp ngoại lệ

Nếu đường dẫn cuối cùng có số đoạn lẻ và không trỏ đến tài liệu.

getDoc(tài liệu tham khảo)

Đọc tài liệu được tham chiếu bởi tham chiếu tài liệu được chỉ định.

Tất cả tài liệu được tìm nạp trực tiếp từ máy chủ, ngay cả khi tài liệu đã được đọc hoặc sửa đổi trước đó. Nội dung sửa đổi gần đây chỉ được phản ánh trong DocumentSnapshot đã truy xuất nếu phần phụ trợ đã áp dụng các nội dung sửa đổi đó. Nếu ứng dụng không có kết nối mạng, thì quá trình đọc sẽ không thành công. Nếu bạn muốn sử dụng tính năng lưu vào bộ nhớ đệm hoặc xem các nội dung sửa đổi cục bộ, vui lòng sử dụng SDK Firestore đầy đủ.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu của tài liệu cần tìm nạp.

Trường hợp trả lại hàng:

Cam kết<DocumentSnapshot<AppModelType, DbModelType>>

Lời hứa đã được giải quyết bằng DocumentSnapshot chứa nội dung tài liệu hiện tại.

setDoc(tài liệu tham khảo, dữ liệu)

Ghi vào tài liệu được tham chiếu đến DocumentReference được chỉ định. Nếu chưa có, tài liệu sẽ được tạo.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu cần viết.
dữ liệu	WithFieldValue<AppModelType>	Bản đồ các trường và giá trị cho tài liệu.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise được phân giải sau khi dữ liệu được ghi thành công vào phần phụ trợ.

Trường hợp ngoại lệ

Lỗi – Nếu thông tin đầu vào mà bạn cung cấp không phải là tài liệu hợp lệ trên Firestore.

setDoc(tài liệu tham khảo, dữ liệu, tuỳ chọn)

Ghi vào tài liệu được tham chiếu đến DocumentReference được chỉ định. Nếu chưa có, tài liệu sẽ được tạo. Nếu cung cấp merge hoặc mergeFields, bạn có thể hợp nhất dữ liệu được cung cấp vào một tài liệu hiện có.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu cần viết.
dữ liệu	Một phầnWithFieldValue<AppModelType>	Bản đồ các trường và giá trị cho tài liệu.
tuỳ chọn	SetOptions	Đối tượng để định cấu hình hành vi đã đặt.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise được phân giải sau khi dữ liệu được ghi thành công vào phần phụ trợ.

Trường hợp ngoại lệ

Lỗi – Nếu thông tin đầu vào mà bạn cung cấp không phải là tài liệu hợp lệ trên Firestore.

updateDoc(tài liệu tham khảo, dữ liệu)

Cập nhật các trường trong tài liệu mà DocumentReference được chỉ định tham chiếu đến. Nội dung cập nhật sẽ không thành công nếu áp dụng cho một tài liệu không tồn tại.

Kết quả của lần cập nhật này sẽ chỉ được phản ánh trong các lần đọc tài liệu xảy ra sau khi phân giải lời hứa được trả về. Nếu máy khách không kết nối mạng, thì quá trình cập nhật sẽ không thành công. Nếu bạn muốn xem nội dung sửa đổi cục bộ hoặc ghi vùng đệm cho đến khi ứng dụng có kết nối mạng, hãy sử dụng toàn bộ SDK Firestore.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu cần cập nhật.
dữ liệu	UpdateData<DbModelType>	Một đối tượng chứa các trường và giá trị cần cập nhật tài liệu. Các trường có thể chứa dấu chấm để tham chiếu đến các trường lồng nhau trong tài liệu.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise được phân giải sau khi dữ liệu được ghi thành công vào phần phụ trợ.

Trường hợp ngoại lệ

Lỗi – Nếu dữ liệu đầu vào được cung cấp không phải là dữ liệu Firestore hợp lệ.

updateDoc(tham chiếu; trường; giá trị; moreFieldsAndValues)

Các trường cập nhật trong tài liệu do DocumentReference chỉ định tham chiếu đến. Quá trình cập nhật sẽ không thành công nếu được áp dụng cho một tài liệu không tồn tại.

Bạn có thể cập nhật các trường lồng nhau bằng cách cung cấp các chuỗi đường dẫn trường được phân tách bằng dấu chấm hoặc bằng cách cung cấp các đối tượng FieldPath.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
tham chiếu	DocumentReference<AppModelType, DbModelType>	Tham chiếu đến tài liệu cần cập nhật.
trường	chuỗi \| FieldPath (Đường dẫn trường)	Trường đầu tiên để cập nhật.
value	không xác định	Giá trị đầu tiên.
moreFieldsAndValues	không xác định[]	Cặp khoá-giá trị bổ sung.

Trường hợp trả lại hàng:

Lời hứa<vô hiệu>

Promise được phân giải sau khi dữ liệu được ghi thành công vào phần phụ trợ.

Trường hợp ngoại lệ

Lỗi – Nếu dữ liệu đầu vào được cung cấp không phải là dữ liệu Firestore hợp lệ.

chức năng(ảnh chụp nhanh, ...)

endAt(ảnh chụp nhanh)

Tạo một QueryEndAtConstraint để sửa đổi kết quả được đặt thành kết thúc tại tài liệu được cung cấp (bao gồm). Vị trí kết thúc tương ứng với thứ tự của truy vấn. Tài liệu phải chứa tất cả các trường được cung cấp theo thứ tự OrderBy của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ảnh chụp nhanh	DocumentSnapshot<AppModelType, DbModelType>	Ảnh chụp nhanh của tài liệu cần kết thúc vào.

Trường hợp trả lại hàng:

QueryEndAtConstraint để truyền đến query()

endTrước(ảnh chụp nhanh)

Tạo một QueryEndAtConstraint để sửa đổi kết quả đã đặt thành kết thúc trước tài liệu được cung cấp (độc quyền). Vị trí kết thúc tương ứng với thứ tự của truy vấn. Tài liệu phải chứa tất cả các trường được cung cấp theo thứ tự OrderBy của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ảnh chụp nhanh	DocumentSnapshot<AppModelType, DbModelType>	Ảnh chụp nhanh của tài liệu cần kết thúc trước đó.

Trường hợp trả lại hàng:

QueryEndAtConstraint để truyền đến query()

startSau(ảnh chụp nhanh)

Tạo một QueryStartAtConstraint giúp sửa đổi nhóm kết quả để bắt đầu sau tài liệu được cung cấp (độc quyền). Vị trí bắt đầu tương ứng với thứ tự của truy vấn. Tài liệu phải chứa tất cả các trường được cung cấp theo thứ tự OrderBy của truy vấn.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ảnh chụp nhanh	DocumentSnapshot<AppModelType, DbModelType>	Ảnh chụp nhanh của tài liệu để bắt đầu sau đó.

Trường hợp trả lại hàng:

QueryStartAtConstraint để truyền đến query()

startAt(ảnh chụp nhanh)

Tạo một QueryStartAtConstraint nhằm sửa đổi tập hợp kết quả để bắt đầu từ tài liệu đã cung cấp (bao gồm). Vị trí bắt đầu tương ứng với thứ tự của truy vấn. Tài liệu phải chứa tất cả các trường được cung cấp trong orderBy của truy vấn này.

Chữ ký:

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

Thông số

Thông số	Loại	Mô tả
ảnh chụp nhanh	DocumentSnapshot<AppModelType, DbModelType>	Ảnh chụp nhanh của tài liệu để bắt đầu.

Trường hợp trả lại hàng: