StorageAccessHandle

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

Instance properties

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

Instance methods

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

• requestStorageAccess()
• Using the Storage Access API