Skip to main content

@rtorcato/browser-common / localstorage

localstorage

Functions

isLocalStorageAvailable()

isLocalStorageAvailable(): boolean

Defined in: localstorage/index.ts:10

Checks if localStorage is available in the current environment.

Example

import { isLocalStorageAvailable } from '@rtorcato/browser-common/localstorage'
if (isLocalStorageAvailable()) loadPrefs()

Returns

boolean

True if localStorage is available, false otherwise.


setLocalStorage()

setLocalStorage(key, value): void

Defined in: localstorage/index.ts:33

Sets a value in localStorage. Automatically stringifies objects.

Example

import { setLocalStorage, getLocalStorage } from '@rtorcato/browser-common/localstorage'
setLocalStorage('prefs', { theme: 'dark' })
const prefs = getLocalStorage('prefs')

Parameters

key

string

The key to set.

value

unknown

The value to store.

Returns

void


getLocalStorage()

getLocalStorage(key): unknown

Defined in: localstorage/index.ts:50

Gets a value from localStorage and parses it as JSON. Returns unknown — callers must narrow before use.

Example

import { getLocalStorage } from '@rtorcato/browser-common/localstorage'
const value = getLocalStorage('prefs') as { theme: string } | null

Parameters

key

string

The key to retrieve.

Returns

unknown

The parsed value, or null if not found or not available.


removeLocalStorage()

removeLocalStorage(key): void

Defined in: localstorage/index.ts:69

Removes a value from localStorage.

Example

import { removeLocalStorage } from '@rtorcato/browser-common/localstorage'
removeLocalStorage('prefs')

Parameters

key

string

The key to remove.

Returns

void


clearLocalStorage()

clearLocalStorage(): void

Defined in: localstorage/index.ts:82

Clears all keys from localStorage.

Example

import { clearLocalStorage } from '@rtorcato/browser-common/localstorage'
clearLocalStorage()

Returns

void