web-api-hooks/dist-src/useSessionStorage.js

Essential set of React Hooks for convenient Web API consumption.

import useStorage from './useStorage';
const getSessionStorage = () => sessionStorage;
/**
 * 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(key, initialValue = null, errorCallback) {
    return useStorage(getSessionStorage, key, initialValue, errorCallback);
}