Interface: UseQueryOpts<IS, CTX, OS>
Defined in: react/hooks.ts:361
Options for the useQuery hook.
Extends
Omit<QueryConfig<IS,OS,CTX>,"db">
Type Parameters
| Type Parameter | Default type |
|---|---|
IS extends Schema | - |
CTX extends ReadonlyJSONValue | - |
OS extends IS | IS |
Properties
| Property | Type | Description | Inherited from | Defined in |
|---|---|---|---|---|
ctx? | CTX | Optional context data passed to predicate and sort functions | Omit.ctx | repo/query.ts:158 |
id? | string | Optional unique identifier for this query | Omit.id | repo/query.ts:156 |
limit? | number | Optional maximum number of results to return | Omit.limit | repo/query.ts:160 |
liveUpdates? | boolean | When true (default), query membership and sort order update immediately when a ManagedItem is edited via set(), without waiting for the 300ms commit delay. Set to false to revert to commit-only update behavior. Rebase events are always ignored since they do not change the document's logical value. | Omit.liveUpdates | repo/query.ts:168 |
predicate? | Predicate<IS, CTX> | Optional predicate function to filter items | Omit.predicate | repo/query.ts:140 |
schema? | IS | Optional schema to restrict query results to | Omit.schema | repo/query.ts:154 |
showIntermittentResults? | boolean | If true, updates UI during the initial scan. If false, waits until scanning is complete. | - | react/hooks.ts:370 |
sortBy? | SortDescriptor<OS, CTX> | keyof OS["fields"] | Optional function or field name to determine sort order of results. If a function is provided, it will be used as a custom comparator. If a field name is provided, results will be sorted by that field's values using standard comparison rules. | Omit.sortBy | repo/query.ts:145 |
sortDescending? | boolean | Optional flag that if true, flips the natural order of the sortBy WARNING: When adding a field that changes query behavior (sorting, filtering, limiting, live updates), you MUST also add it to the key computation in generateQueryId() below so the cache identity captures the difference. Otherwise distinct configurations will collide. | Omit.sortDescending | repo/query.ts:152 |
source | QuerySource<IS, OS> | The source repository, query or path to query from | Omit.source | repo/query.ts:138 |