You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|[increment(n)](./firestore_.md#increment_5685735)| Returns a special value that can be used with [setDoc()](./firestore_lite.md#setdoc_ee215ad) or [updateDoc()](./firestore_lite.md#updatedoc_51a65e3) that tells the server to increment the field's current value by the given value.<!---->If either the operand or the current field value uses floating point precision, all arithmetic follows IEEE 754 semantics. If both values are integers, values outside of JavaScript's safe number range (<code>Number.MIN_SAFE_INTEGER</code> to <code>Number.MAX_SAFE_INTEGER</code>) are also subject to precision loss. Furthermore, once processed by the Firestore backend, all integer operations are capped between -2^63 and 2^63-1.<!---->If the current field value is not of type <code>number</code>, or if the field does not yet exist, the transformation sets the field to the given value. |
84
84
| <b>function(query, ...)</b> |
85
-
|[getAggregateFromServer(query, aggregateSpec)](./firestore_.md#getaggregatefromserver_2073a74)| Calculates the specified aggregations over the documents in the result set of the given query, without actually downloading the documents.<!---->Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can even perform aggregations of the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).<!---->The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used: every request using this source necessarily involves a round trip to the server. |
86
-
|[getCountFromServer(query)](./firestore_.md#getcountfromserver_4e56953)| Calculates the number of documents in the result set of the given query, without actually downloading the documents.<!---->Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can even count the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).<!---->The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used: every request using this source necessarily involves a round trip to the server. |
85
+
|[getAggregateFromServer(query, aggregateSpec)](./firestore_.md#getaggregatefromserver_2073a74)| Calculates the specified aggregations over the documents in the result set of the given query without actually downloading the documents.<!---->Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can perform aggregations of the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).<!---->The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used. Every invocation of this function necessarily involves a round trip to the server. |
86
+
|[getCountFromServer(query)](./firestore_.md#getcountfromserver_4e56953)| Calculates the number of documents in the result set of the given query without actually downloading the documents.<!---->Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can count the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).<!---->The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used. Every invocation of this function necessarily involves a round trip to the server. |
87
87
|[getDocs(query)](./firestore_.md#getdocs_4e56953)| Executes the query and returns the results as a <code>QuerySnapshot</code>.<!---->Note: <code>getDocs()</code> attempts to provide up-to-date data when possible by waiting for data from the server, but it may return cached data or fail if you are offline and the server cannot be reached. To specify this behavior, invoke [getDocsFromCache()](./firestore_.md#getdocsfromcache_4e56953) or [getDocsFromServer()](./firestore_.md#getdocsfromserver_4e56953)<!---->. |
88
88
|[getDocsFromCache(query)](./firestore_.md#getdocsfromcache_4e56953)| Executes the query and returns the results as a <code>QuerySnapshot</code> from cache. Returns an empty result set if no documents matching the query are currently cached. |
89
89
|[getDocsFromServer(query)](./firestore_.md#getdocsfromserver_4e56953)| Executes the query and returns the results as a <code>QuerySnapshot</code> from the server. Returns an error if the network is not available. |
@@ -1489,11 +1489,11 @@ The `FieldValue` sentinel for use in a call to `setDoc()` or `updateDoc()`
Calculates the specified aggregations over the documents in the result set of the given query, without actually downloading the documents.
1492
+
Calculates the specified aggregations over the documents in the result set of the given query without actually downloading the documents.
1493
1493
1494
-
Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can even perform aggregations of the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).
1494
+
Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can perform aggregations of the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).
1495
1495
1496
-
The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used: every request using this source necessarily involves a round trip to the server.
1496
+
The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used. Every invocation of this function necessarily involves a round trip to the server.
1497
1497
1498
1498
<b>Signature:</b>
1499
1499
@@ -1505,7 +1505,7 @@ export declare function getAggregateFromServer<AggregateSpecType extends Aggrega
1505
1505
1506
1506
| Parameter | Type | Description |
1507
1507
| --- | --- | --- |
1508
-
| query |[Query](./firestore_.query.md#query_class)<!----><AppModelType, DbModelType>| The query whose result set to aggregate over. |
1508
+
| query |[Query](./firestore_.query.md#query_class)<!----><AppModelType, DbModelType>| The query whose result set is aggregated over. |
1509
1509
| aggregateSpec | AggregateSpecType | An <code>AggregateSpec</code> object that specifies the aggregates to perform over the result set. The AggregateSpec specifies aliases for each aggregate, which can be used to retrieve the aggregate result. |
Calculates the number of documents in the result set of the given query, without actually downloading the documents.
1533
+
Calculates the number of documents in the result set of the given query without actually downloading the documents.
1534
1534
1535
-
Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can even count the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).
1535
+
Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can count the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).
1536
1536
1537
-
The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used: every request using this source necessarily involves a round trip to the server.
1537
+
The result received from the server is presented, unaltered, without considering any local state. That is, documents in the local cache are not taken into consideration, neither are local modifications not yet synchronized with the server. Previously-downloaded results, if any, are not used. Every invocation of this function necessarily involves a round trip to the server.
|[increment(n)](./firestore_lite.md#increment_5685735)| Returns a special value that can be used with [setDoc()](./firestore_lite.md#setdoc_ee215ad) or [updateDoc()](./firestore_lite.md#updatedoc_51a65e3) that tells the server to increment the field's current value by the given value.<!---->If either the operand or the current field value uses floating point precision, all arithmetic follows IEEE 754 semantics. If both values are integers, values outside of JavaScript's safe number range (<code>Number.MIN_SAFE_INTEGER</code> to <code>Number.MAX_SAFE_INTEGER</code>) are also subject to precision loss. Furthermore, once processed by the Firestore backend, all integer operations are capped between -2^63 and 2^63-1.<!---->If the current field value is not of type <code>number</code>, or if the field does not yet exist, the transformation sets the field to the given value. |
66
66
| <b>function(query, ...)</b> |
67
-
|[getAggregate(query, aggregateSpec)](./firestore_lite.md#getaggregate_2073a74)| Calculates the specified aggregations over the documents in the result set of the given query, without actually downloading the documents.<!---->Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can even perform aggregations of the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents). |
68
-
|[getCount(query)](./firestore_lite.md#getcount_4e56953)| Calculates the number of documents in the result set of the given query, without actually downloading the documents.<!---->Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can even count the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents). |
67
+
|[getAggregate(query, aggregateSpec)](./firestore_lite.md#getaggregate_2073a74)| Calculates the specified aggregations over the documents in the result set of the given query without actually downloading the documents.<!---->Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can perform aggregations of the documents in cases where the result set is prohibitively large to download entirely (thousands of documents). |
68
+
|[getCount(query)](./firestore_lite.md#getcount_4e56953)| Calculates the number of documents in the result set of the given query without actually downloading the documents.<!---->Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can count the documents in cases where the result set is prohibitively large to download entirely (thousands of documents). |
69
69
|[getDocs(query)](./firestore_lite.md#getdocs_4e56953)| Executes the query and returns the results as a [QuerySnapshot](./firestore_.querysnapshot.md#querysnapshot_class)<!---->.<!---->All queries are executed directly by the server, even if the the query was previously executed. Recent modifications are only reflected in the retrieved results if they have already been applied by the backend. If the client is offline, the operation fails. To see previously cached result and local modifications, use the full Firestore SDK. |
70
70
|[query(query, compositeFilter, queryConstraints)](./firestore_lite.md#query_9f7b0f4)| Creates a new immutable instance of [Query](./firestore_.query.md#query_class) that is extended to also include additional query constraints. |
71
71
|[query(query, queryConstraints)](./firestore_lite.md#query_0f46da1)| Creates a new immutable instance of [Query](./firestore_.query.md#query_class) that is extended to also include additional query constraints. |
@@ -982,9 +982,9 @@ The `FieldValue` sentinel for use in a call to `setDoc()` or `updateDoc()`
Calculates the specified aggregations over the documents in the result set of the given query, without actually downloading the documents.
985
+
Calculates the specified aggregations over the documents in the result set of the given query without actually downloading the documents.
986
986
987
-
Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can even perform aggregations of the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).
987
+
Using this function to perform aggregations is efficient because only the final aggregation values, not the documents' data, are downloaded. This function can perform aggregations of the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).
988
988
989
989
<b>Signature:</b>
990
990
@@ -996,7 +996,7 @@ export declare function getAggregate<AggregateSpecType extends AggregateSpec, Ap
996
996
997
997
| Parameter | Type | Description |
998
998
| --- | --- | --- |
999
-
| query |[Query](./firestore_lite.query.md#query_class)<!----><AppModelType, DbModelType>| The query whose result set to aggregate over. |
999
+
| query |[Query](./firestore_lite.query.md#query_class)<!----><AppModelType, DbModelType>| The query whose result set is aggregated over. |
1000
1000
| aggregateSpec | AggregateSpecType | An <code>AggregateSpec</code> object that specifies the aggregates to perform over the result set. The AggregateSpec specifies aliases for each aggregate, which can be used to retrieve the aggregate result. |
Calculates the number of documents in the result set of the given query, without actually downloading the documents.
1024
+
Calculates the number of documents in the result set of the given query without actually downloading the documents.
1025
1025
1026
-
Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can even count the documents if the result set would be prohibitively large to download entirely (e.g. thousands of documents).
1026
+
Using this function to count the documents is efficient because only the final count, not the documents' data, is downloaded. This function can count the documents in cases where the result set is prohibitively large to download entirely (thousands of documents).
0 commit comments