MDN self-hosted library · e01.org

StorageAccessHandle

Storage Access API

Storage Access API

The StorageAccessHandle interface represents access to unpartitioned state granted by a call to Document.requestStorageAccess().

Instance properties

  • StorageAccessHandle.sessionStorage
  • : Returns an unpartitioned session Storage object if access was granted.
  • StorageAccessHandle.localStorage
  • : Returns an unpartitioned local Storage object if access was granted.
  • StorageAccessHandle.indexedDB
  • : Returns an unpartitioned IDBFactory object if access was granted.
  • StorageAccessHandle.locks
  • : Returns an unpartitioned LockManager object if access was granted.
  • StorageAccessHandle.caches
  • : Returns an unpartitioned CacheStorage object if access was granted.

Instance methods

  • StorageAccessHandle.getDirectory()
  • : Returns a Promise that fulfills with an unpartitioned FileSystemDirectoryHandle object if access was granted, and rejects otherwise.
  • StorageAccessHandle.estimate()
  • : Returns a Promise that fulfills with an unpartitioned StorageEstimate object if access was granted, and rejects otherwise.
  • StorageAccessHandle.createObjectURL()
  • : Returns a string representing the unpartitioned blob storage url created if access was granted, and throws otherwise.
  • StorageAccessHandle.revokeObjectURL()
  • : Revokes the unpartitioned blob storage url passed in if access was granted, and throws otherwise.
  • StorageAccessHandle.BroadcastChannel()
  • : Returns the unpartitioned BroadcastChannel created if access was granted, and throws otherwise.
  • StorageAccessHandle.SharedWorker()
  • : Returns the unpartitioned SharedWorker created if access was granted, and throws otherwise.

Example

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

Browser compatibility

See also