clear

Category: Storage

Namespace: web.storage.clear

Description

Delete all keys from the app's persistent key-value store. Resets storage.json to an empty object. Does not affect files written with writeFile.

Syntax

await web.storage.clear();

Parameters

None

Returns

Promise<boolean> - Resolves true on success

Example

Simple example

await web.storage.clear();

Practical example — factory reset

async function resetToDefaults() {
    const confirmed = confirm('Reset all settings to defaults?');
    if (!confirmed) return;

    await web.storage.clear();
    location.reload();
}

Advanced example — selective clear using keys()

// Clear only keys that start with 'cache_' instead of clearing everything
const allKeys = await web.storage.keys();
for (const key of allKeys) {
    if (key.startsWith('cache_')) {
        await web.storage.remove({ key });
    }
}

Related Methods

• web.storage.remove() - Delete a single key
• web.storage.keys() - List all key names
• web.storage.set() - Save a value by key

Notes

• Only clears the key-value store (storage.json) — files written with writeFile are not affected
• This operation cannot be undone