BrowserStorage

Source

localStorage adapter with prefix-based key isolation. All keys are stored as ${prefix}_${id}.

Constructor

new BrowserStorage(prefix?: string)

Parameters:

Name	Type	Required	Description
prefix	string	No	Key prefix for namespace isolation. Defaults to "storage_prefix".

Throws: Error("localStorage is not supported in this environment.") — if localStorage is not available.

Methods

write

write(id: string, data: string): void

Writes data to localStorage under the prefixed key.

Parameters:

Name	Type	Required	Description
id	string	Yes	Data identifier.
data	string	Yes	String value to store.

read

read(id: string): string | null

Reads data from localStorage.

Parameters:

Name	Type	Required	Description
id	string	Yes	Data identifier.

Returns: string | null — stored value, or null if not found.

delete

delete(id: string): void

Removes a prefixed key from localStorage.

Parameters:

Name	Type	Required	Description
id	string	Yes	Data identifier to delete.

has

has(id: string): boolean

Checks if a key exists in localStorage.

Parameters:

Name	Type	Required	Description
id	string	Yes	Data identifier.

Returns: boolean.

isEmpty

isEmpty(): boolean

Returns true if no prefixed keys exist in localStorage.

Returns: boolean.

clear

clear(): void

Removes all keys with the configured prefix from localStorage.