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:165


fallback

fallback: TValue

The value provided by the fallback option.

Source

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


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:161

Methods

getMeta()

getMeta(): Promise<NullablePartial<TMetadata>>

Get metadata.

Source

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


getValue()

getValue(): Promise<TValue>

Get the latest value from storage.

Source

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


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:204


removeMeta()

removeMeta(properties?): Promise<void>

Remove all metadata or certain properties from metadata.

Parameters

properties?: string[]

Source

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


removeValue()

removeValue(opts?): Promise<void>

Remove the value from storage.

Parameters

opts?: RemoveItemOptions

Source

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


setMeta()

setMeta(properties): Promise<void>

Set metadata properties.

Parameters

properties: NullablePartial<TMetadata>

Source

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


setValue()

setValue(value): Promise<void>

Set the value in storage.

Parameters

value: TValue

Source

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


watch()

watch(cb): Unwatch

Listen for changes to the value in storage.

Parameters

cb: WatchCallback<TValue>

Source

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


Generated using typedoc-plugin-markdown and TypeDoc