DocQuery:ready() -> DocQueryWait until this operation completes, then return the same handle for chaining. Raises if the operation failed. A completed handle returns at once.
handle2 methods, 2 fields
An in-flight document prefix query. entries raises until it is ready — await :ready() or datumhue.ready, or probe state.
Document:query_prefix| Field | Type | Access | Description |
|---|---|---|---|
state | ReadyState | read-only | Completion state of this operation. Reading it never raises or suspends; a failed operation's error surfaces at :ready(). |
entries | table<string, documents.Entry> | read-only | Every key under the prefix mapped to its {value, meta} entry, newest per key. |
DocQuery:ready() -> DocQueryWait until this operation completes, then return the same handle for chaining. Raises if the operation failed. A completed handle returns at once.
DocQuery:on_done(callback?: fun(handle: DocQuery))Set, replace, or clear (pass nil) the callback run once, as a callback of its own, when this operation leaves pending. On a handle that has already left it, the callback runs after the current callback returns, never during this call. A set callback keeps the operation's outcome alive, even with no other reference to the handle, and keeps the app running until it runs or is cleared.