@toolz/session-storage-is-available

1.0.0 • Public • Published

session-storage-is-available

session-storage-is-available is a tiny utility function to safely determine whether sessionStorage is available in the current environment. It's dangerous to assume that sessionStorage() is available. It can be absent in non-supported browsers, or when scripts are invoked from the command line, or when the user's browser is in Incognito Mode. Trying to access sessionStorage() when it's unavailable can spawn an Error. So it's best to test for its existence before attempting to access it.

Usage

After installation, import the package:

import { sessionStorageIsAvailable } from '@toolz/session-storage-is-available';

sessionStorageIsAvailable()

sessionStorageIsAvailable() attempts to set-and-remove a value in sessionStorage, returning a Boolean value based on its failure or success.

const API = {
   arguments: {
      // none
   },
   returns: Boolean,
}

Examples:

sessionStorageIsAvailable(); // returns Boolean TRUE in "normal" browser situations
sessionStorageIsAvailable(); // returns Boolean FALSE when invoked outside a "normal" browser
                             // or when the browser can sessionStorage disabled (e.g., Incognito Mode)

Package Sidebar

Install

npm i @toolz/session-storage-is-available

Weekly Downloads

104

Version

1.0.0

License

MIT

Unpacked Size

4.58 kB

Total Files

6

Last publish

Collaborators

  • bytebodger