StorageAccessHandle: locks property

Limited availability

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

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

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

See also