Reference
Arcane.storage.get()
Reads one app-scoped JSON value. A missing key resolves with found:false,value:null. Requires storage.read.
This focused page is derived from the mechanically checked full member inventory.
Syntax
Arcane.storage.get(key)
Parameters
key: 1–128-character app-storage key
Return value
Promise<{key, found:boolean, value}>
Description
Reads one app-scoped JSON value. A missing key resolves with found:false,value:null. Requires storage.read.
Overview
Reads one JSON-compatible value from the current application's native storage.
Use the explicit found flag to distinguish a missing key from a stored null.
Key and return value
The key must contain 1–128 letters, numbers, periods, underscores, colons, or
hyphens and begin with a letter or number. The promise resolves to
{key,found,value}; a missing key returns found:false and value:null rather
than rejecting.
Requires storage.read.
Errors and recovery
Invalid keys reject with INVALID_STORAGE_KEY; correct the key rather than
retrying. A capability rejection means this application cannot read native
storage. Treat a host or transport failure as an unavailable read, not as a
missing record, so the UI does not silently replace unknown data with defaults.
Example
async function loadDraft() {
const result = await Arcane.storage.get('editor.draft.current');
return result.found ? result.value : { text: '', updatedAt: null };
}
const draft = await loadDraft();
console.log(draft.updatedAt);