coderef

PermissionsBaseline · Widely available

The navigator.permissions API checks whether a permission, such as access to geolocation data, has been granted.

Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Sep 12, 2022. Widely available since Mar 12, 2025.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–43Not supported
44+Supportedsince Jul 21, 2015
Current: 155
Edge
12–18Not supported
79+Supportedsince Jan 15, 2020
Current: 154
Firefox
1–45Not supported
46+Supportedsince Apr 26, 2016
Current: 157
Safari
1–15.6Not supported
16+Supportedsince Sep 12, 2022
Current: 27
MobileChrome Android
18–43Not supported
44+Supportedsince Jul 29, 2015
Current: 155
Firefox Android
4–45Not supported
46+Supportedsince Apr 26, 2016
Current: 157
Safari iOS
1–15.6Not supported
16+Supportedsince Sep 12, 2022
Current: 27

How to use

This feature is Baseline widely available — use it freely, no fallback needed.

Example

Full syntax and examples are on MDN: permissions.

Feature detection

JS · check before using
if ("Permissions" in globalThis) {
  // Permissions is available
} else {
  // load a polyfill or use a fallback
}

Documentation (MDN)

Specification

Usage share

Sub-features

Support for each part of the feature (9). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
Navigator.permissions43794616434616
PermissionStatus43794616434616
PermissionStatus.change_event437946✕4346✕
PermissionStatus.name97979316979316
PermissionStatus.state44794616444616
Permissions43794616434616
Permissions.query43794616434616
Permissions.request✕✕✕✕✕✕✕
WorkerNavigator.permissions437913316.44313316.4