permissions

Query and watch permission status via the Permissions API.

Import: @rtorcato/browser-common/permissions

📖 MDN: Permissions API · 📊 caniuse: permissions-api

Query only; support varies by permission name.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
Permissions.query	✅ 43+	✅ 79+	✅ 46+	✅ 16+	✅ 16+	Widely available

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

Example

import { isPermissionsApiAvailable, queryPermission, onPermissionChange } from '@rtorcato/browser-common/permissions'

if (isPermissionsApiAvailable()) {
  const state = await queryPermission('geolocation')

  const status = await navigator.permissions.query({ name: 'geolocation' })
  const off = onPermissionChange(status, () => console.log(status.state))
  off()
}

Exports

• isPermissionsApiAvailable() — feature check
• queryPermission(name) — resolves a permission's state ('granted' | 'denied' | 'prompt'), or undefined if unsupported
• onPermissionChange(status, callback) — subscribes to a PermissionStatus change event, returns an unsubscribe function

See the API reference for full signatures.