StorageAccessHandle: locks property

Limited availability

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

The locks property of the StorageAccessHandle interface returns an unpartitioned session LockManager object if access was granted, and throws a SecurityError DOMException otherwise.

Value

A LockManager object.

Examples

js
document.requestStorageAccess({ locks: true }).then(
  (handle) => {
    console.log("locks access granted");
    await handle.locks.request('foo', async lock => {
        return "ok";
    });
  },
  () => {
    console.log("locks 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-locks

Browser compatibility

BCD tables only load in the browser

See also