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.

Returns

boolean

True if localStorage is available, false otherwise.

Example

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

setLocalStorage()

setLocalStorage(key, value): void

Defined in: localstorage/index.ts:33

Sets a value in localStorage. Automatically stringifies objects.

Parameters

key

string

The key to set.

value

unknown

The value to store.

Returns

void

Example

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

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.

Parameters

key

string

The key to retrieve.

Returns

unknown

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

Example

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

removeLocalStorage()

removeLocalStorage(key): void

Defined in: localstorage/index.ts:69

Removes a value from localStorage.

Parameters

key

string

The key to remove.

Returns

void

Example

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

clearLocalStorage()

clearLocalStorage(): void

Defined in: localstorage/index.ts:82

Clears all keys from localStorage.

Returns

void

Example

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