DocEntry:ready() -> DocEntryWait until this operation completes, then return the same handle for chaining. Raises if the operation failed. A completed handle returns at once.
handle2 methods, 3 fields
DocEntry
An in-flight single-key document read. Payload fields raise until it is ready — await :ready() or datumhue.ready, or probe state. value and meta are both nil when the key is absent (or deleted) — an absent key never fails a barrier.
- Obtained from
Document:get
Fields 3
| 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(). |
value | nil | boolean | integer | number | string | table | read-only | The stored value, or nil when the key is absent. |
meta | documents.Meta? | read-only | Write metadata, or nil when the key is absent. |
Methods 2
DocEntry:on_done
methodDocEntry:on_done(callback?: fun(handle: DocEntry))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.