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


fallback

fallback: TValue

The value provided by the fallback option.

Source

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


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

Methods

getMeta()

getMeta(): Promise<NullablePartial<TMetadata>>

Get metadata.

Source

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


getValue()

getValue(): Promise<TValue>

Get the latest value from storage.

Source

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


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


removeMeta()

removeMeta(properties?): Promise<void>

Remove all metadata or certain properties from metadata.

Parameters

properties?: string[]

Source

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


removeValue()

removeValue(opts?): Promise<void>

Remove the value from storage.

Parameters

opts?: RemoveItemOptions

Source

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


setMeta()

setMeta(properties): Promise<void>

Set metadata properties.

Parameters

properties: NullablePartial<TMetadata>

Source

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


setValue()

setValue(value): Promise<void>

Set the value in storage.

Parameters

value: TValue

Source

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


watch()

watch(cb): Unwatch

Listen for changes to the value in storage.

Parameters

cb: WatchCallback<TValue>

Source

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


Generated using typedoc-plugin-markdown and TypeDoc