Skip to content

API > wxt/utils/storage > WxtStorageItem

Interface: WxtStorageItem<TValue, TMetadata>

Contents

Type parameters

TValue

TMetadata extends Record<string, unknown>

Properties

defaultValue

defaultValue: TValue

Deprecated

Renamed to fallback, use it instead.

Source

packages/storage/dist/index.d.mts:162


fallback

fallback: TValue

The value provided by the fallback option.

Source

packages/storage/dist/index.d.mts:166


key

key: `local:${string}` | `session:${string}` | `sync:${string}` | `managed:${string}`

The storage key passed when creating the storage item.

Source

packages/storage/dist/index.d.mts:158

Methods

getMeta()

getMeta(): Promise<NullablePartial<TMetadata>>

Get metadata.

Source

packages/storage/dist/index.d.mts:174


getValue()

getValue(): Promise<TValue>

Get the latest value from storage.

Source

packages/storage/dist/index.d.mts:170


migrate()

migrate(): Promise<void>

If there are migrations defined on the storage item, migrate to the latest version.

This function is ran automatically whenever the extension updates, so you don't have to call it manually.

Source

packages/storage/dist/index.d.mts:201


removeMeta()

removeMeta(properties?): Promise<void>

Remove all metadata or certain properties from metadata.

Parameters

properties?: string[]

Source

packages/storage/dist/index.d.mts:190


removeValue()

removeValue(opts?): Promise<void>

Remove the value from storage.

Parameters

opts?: RemoveItemOptions

Source

packages/storage/dist/index.d.mts:186


setMeta()

setMeta(properties): Promise<void>

Set metadata properties.

Parameters

properties: NullablePartial<TMetadata>

Source

packages/storage/dist/index.d.mts:182


setValue()

setValue(value): Promise<void>

Set the value in storage.

Parameters

value: TValue

Source

packages/storage/dist/index.d.mts:178


watch()

watch(cb): Unwatch

Listen for changes to the value in storage.

Parameters

cb: WatchCallback<TValue>

Source

packages/storage/dist/index.d.mts:194


Generated using typedoc-plugin-markdown and TypeDoc