localstorage

JSON-aware wrappers around localStorage, with an availability check and safe no-ops when storage is unavailable (private browsing, quota, etc.).

Import: @rtorcato/browser-common/localstorage

📖 MDN: Web Storage API · 📊 caniuse: namevalue-storage

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
Window.localStorage	✅ 4+	✅ 12+	✅ 3.5+	✅ 4+	✅ 3.2+	Widely available

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: Window.localStorage

Example

import {
  isLocalStorageAvailable,
  setLocalStorage,
  getLocalStorage,
  removeLocalStorage,
} from '@rtorcato/browser-common/localstorage'

if (isLocalStorageAvailable()) {
  setLocalStorage('prefs', { theme: 'dark' })
  const prefs = getLocalStorage('prefs') as { theme: string } | null
  removeLocalStorage('prefs')
}

Exports

• isLocalStorageAvailable() — feature check, verified with a write/remove probe
• setLocalStorage(key, value) — JSON-stringifies and stores value
• getLocalStorage(key) — parses and returns the stored value, or null (caller must narrow the type)
• removeLocalStorage(key) — removes a single key
• clearLocalStorage() — clears all keys

See the API reference for full signatures.