StorageAccessHandle: localStorage property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The localStorage property of the StorageAccessHandle interface returns an unpartitioned local Storage object if access was granted, and throws a SecurityError DOMException otherwise.

Value

A Storage object.

Examples

js
document.requestStorageAccess({ localStorage: true }).then(
  (handle) => {
    console.log("localStorage access granted");
    handle.localStorage.setItem("foo", "bar");
  },
  () => {
    console.log("localStorage access denied");
  },
);

Note: See Using the Storage Access API for a more complete example.

Specifications

Specification
Extending Storage Access API (SAA) to non-cookie storage
# ref-for-dom-storageaccesshandle-localstorage

Browser compatibility

BCD tables only load in the browser

See also