A QuerySnapshot contains zero or more [QueryDocumentSnapshot]QueryDocumentSnapshot objects representing the results of a query. The documents can be accessed as an array via the [documents] property or enumerated using the [forEach] method. The number of documents can be determined via the [empty] and [size] properties.
QuerySnapshot
Package
@google-cloud/firestore!Constructors
(constructor)(_query, _readTime, _size, docs, changes)
constructor(_query: Query<T>, _readTime: Timestamp, _size: number, docs: () => Array<QueryDocumentSnapshot<T>>, changes: () => Array<DocumentChange<T>>);
Constructs a new instance of the QuerySnapshot
class
Name | Description |
_query |
Query<T>
The originating query. |
_readTime |
Timestamp
The time when this query snapshot was obtained. |
_size |
number
The number of documents in the result set. |
docs |
() => Array<QueryDocumentSnapshot<T>>
A callback returning a sorted array of documents matching this query |
changes |
() => Array<DocumentChange<T>>
A callback returning a sorted array of document change events for this snapshot. |
Properties
docs
get docs(): Array<QueryDocumentSnapshot<T>>;
An array of all the documents in this QuerySnapshot.
{Array.
Type | Description |
Array<QueryDocumentSnapshot<T>> |
empty
get empty(): boolean;
True if there are no documents in the QuerySnapshot.
{boolean} QuerySnapshot#empty
Type | Description |
boolean |
query
get query(): Query<T>;
The query on which you called get() or onSnapshot() in order to get this QuerySnapshot.
{Query} QuerySnapshot#query
Type | Description |
Query<T> |
readTime
get readTime(): Timestamp;
The time this query snapshot was obtained.
{Timestamp} QuerySnapshot#readTime
Type | Description |
Timestamp |
size
get size(): number;
The number of documents in the QuerySnapshot.
{number} QuerySnapshot#size
Type | Description |
number |
Methods
docChanges()
docChanges(): Array<DocumentChange<T>>;
Returns an array of the documents changes since the last snapshot. If this is the first snapshot, all documents will be in the list as added changes.
{Array.
Type | Description |
Array<DocumentChange<T>> |
forEach(callback, thisArg)
forEach(callback: (result: firestore.QueryDocumentSnapshot<T>) => void, thisArg?: unknown): void;
Enumerates all of the documents in the QuerySnapshot. This is a convenience method for running the same callback on each QueryDocumentSnapshot that is returned.
Name | Description |
callback |
(result: FirebaseFirestore.QueryDocumentSnapshot<T>) => void
A callback to be called with a [QueryDocumentSnapshot]QueryDocumentSnapshot for each document in the snapshot. |
thisArg |
unknown
The |
Type | Description |
void |
isEqual(other)
isEqual(other: firestore.QuerySnapshot<T>): boolean;
Returns true if the document data in this QuerySnapshot
is equal to the provided value.
Name | Description |
other |
FirebaseFirestore.QuerySnapshot<T>
The value to compare against. {boolean} true if this |
Type | Description |
boolean |