weblocks

Coordinate work across tabs and workers with a named, async lock via the Web Locks API.

Import: @rtorcato/browser-common/weblocks

📖 MDN: Web Locks API · 📊 caniuse: weblocks

Web Locks API needs a secure context. withLock throws where unsupported — guard with isWebLocksAvailable() first.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
LockManager.request	✅ 69+	✅ 79+	✅ 96+	✅ 15.4+	✅ 15.4+	Widely available

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: LockManager.request

Example

import { isWebLocksAvailable, withLock } from '@rtorcato/browser-common/weblocks'

if (isWebLocksAvailable()) {
  const result = await withLock('sync', async () => fetchAndStore())
}

Exports

• isWebLocksAvailable() — feature check
• withLock(name, callback) — runs callback while holding the named lock; returns the callback's result

See the API reference for full signatures.