Session Storage Utilities

Overview

A simple set of utilities to interact safely with the browser's Session Storage API. Handles storing, retrieving, and removing typed items scoped to a browser tab session.

getFromSessionStorage

Retrieves a value from session storage, parsing it back into its original type.

Function Signature

function getFromSessionStorage<T>(
  key: string,
  deserialize?: Deserializer<T>
): T | null

Parameters

Returns

• T | null: The parsed value of type T, or null if the key does not exist or parsing fails.

Example Usage

import { getFromSessionStorage } from 'toolbox-x/dom';

const color = getFromSessionStorage<string>('color');
console.log(color); // → e.g. 'blue'

saveToSessionStorage

Stores a value in session storage, automatically stringifying objects/arrays.

Function Signature

function saveToSessionStorage<T>(
  key: string,
  value: T,
  serialize?: Serializer<T>
): void

Parameters

Example Usage

import { saveToSessionStorage } from 'toolbox-x/dom';

saveToSessionStorage('count', 10);
saveToSessionStorage('profile', { id: 7, username: 'user7' });

removeFromSessionStorage

Removes an item from session storage.

Function Signature

function removeFromSessionStorage(key: string): void

Parameters

Example Usage

import { removeFromSessionStorage } from 'toolbox-x/dom';

removeFromSessionStorage('cart');

Related Utilities

• localStorage — Scopes equivalent utility operations to the browser's persistent storage.