web-api-hooks/dist-types/useSessionStorage.d.ts

Essential set of React Hooks for convenient Web API consumption.

/// <reference types="react" />
import { JSONValue } from './types';
/**
 * Stores a key/value pair statefully in [`sessionStorage`](https://developer.mozilla.org/docs/Web/API/Window/sessionStorage).
 *
 * @see [`useState` hook](https://reactjs.org/docs/hooks-reference.html#usestate), which exposes a similar interface
 *
 * @param key Identifier to associate the stored value with.
 * @param initialValue Value used when no item exists with the given key. Lazy initialization is available by using a function which returns the desired value.
 * @param errorCallback Method to execute in case of an error, e.g. when the storage quota has been exceeded or trying to store a circular data structure.
 * @returns A statefully stored value, and a function to update it.
 *
 * @example
 * function Component() {
 *   const [name, setName] = useSessionStorage<string>('name', 'Anonymous');
 *   // ...
 * }
 */
export default function useSessionStorage<T extends JSONValue>(key: string, initialValue?: T | (() => T) | null, errorCallback?: (error: DOMException | TypeError) => void): [T, React.Dispatch<React.SetStateAction<T>>];