Web/API/Permissions

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

The Permissions interface of the Permissions API provides the core Permission API functionality, such as methods for querying and revoking permissions

Methods

Permissions.query()

Returns the user permission status for a given API.

Permissions.request()

Requests permission to use a given API. This is not currently supported in any browser.

Permissions.requestAll()

Requests permission to use a given set of APIs. This is not currently supported in any browser.

Permissions.revoke()

Revokes the permission currently set on a given API.

Example

navigator.permissions.query({name:'geolocation'}).then(function(result) {
  if (result.state === 'granted') {
    showLocalNewsWithGeolocation();
  } else if (result.state === 'prompt') {
    showButtonToEnableLocalNews();
  }
  // Don't do anything if the permission was denied.
});

Specification

Specification	Status	Comment
PermissionsThe definition of 'Permissions' in that specification.	Working Draft	Initial definition.

Browser Support

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Permissions	Chrome Full support 43	Edge Full support 79	Firefox Full support 46	IE No support No	Opera Full support Yes	Safari No support No	WebView Android Full support 43	Chrome Android Full support 43	Firefox Android Full support 46	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support 4.0
accelerometer permission	Chrome Full support 62	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 62	Chrome Android Full support 62	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 8.0
accessibility-events permission	Chrome Full support 62	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 62	Chrome Android Full support 62	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 8.0
ambient-light-sensor permission	Chrome Full support 62	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 62	Chrome Android Full support 62	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 8.0
background-sync permission	Chrome Full support 62	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 62	Chrome Android Full support 62	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 8.0
camera permission	Chrome Full support 64	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 64	Chrome Android Full support 64	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 9.0
clipboard-read permission	Chrome Full support 64	Edge Full support 79	Firefox No support No	IE No support No	Opera ?	Safari No support No	WebView Android Full support 64	Chrome Android Full support 64	Firefox Android No support No	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 9.0
clipboard-write permission	Chrome Full support 64	Edge Full support 79	Firefox No support No	IE No support No	Opera ?	Safari No support No	WebView Android Full support 64	Chrome Android Full support 64	Firefox Android No support No	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 9.0
geolocation permission	Chrome Full support 43	Edge Full support 79	Firefox ?	IE No support No	Opera Full support 30	Safari No support No	WebView Android No support No	Chrome Android Full support 43	Firefox Android ?	Opera Android Full support 30	Safari iOS No support No	Samsung Internet Android Full support 4.0
gyroscope permission	Chrome Full support 51	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 51	Chrome Android Full support 51	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 5.0
magnetometer permission	Chrome Full support 62	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 62	Chrome Android Full support 62	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 8.0
microphone permission	Chrome Full support 64	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 64	Chrome Android Full support 64	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 9.0
midi permission	Chrome Full support 43	Edge Full support 79	Firefox ?	IE No support No	Opera Full support 30	Safari No support No	WebView Android No support No	Chrome Android Full support 43	Firefox Android ?	Opera Android Full support 30	Safari iOS No support No	Samsung Internet Android Full support 4.0
notifications permission	Chrome Full support 43	Edge Full support 79	Firefox ?	IE No support No	Opera Full support 30	Safari No support No	WebView Android No support No	Chrome Android Full support 43	Firefox Android ?	Opera Android Full support 30	Safari iOS No support No	Samsung Internet Android Full support 4.0
payment-handler permission	Chrome Full support 66	Edge Full support 79	Firefox ?	IE No support No	Opera ?	Safari No support No	WebView Android Full support 66	Chrome Android Full support 66	Firefox Android ?	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 9.0
persistent-storage permission	Chrome Full support 71	Edge Full support 79	Firefox Full support 53	IE No support No	Opera Full support 58	Safari No support No	WebView Android Full support 71	Chrome Android Full support 71	Firefox Android Full support 53	Opera Android Full support 50	Safari iOS No support No	Samsung Internet Android Full support 10.0
push permission	Chrome Full support 43	Edge Full support 79	Firefox ?	IE No support No	Opera Full support 30	Safari No support No	WebView Android No support No	Chrome Android Full support 43	Firefox Android ?	Opera Android Full support 30	Safari iOS No support No	Samsung Internet Android Full support 4.0
query	Chrome Full support 43	Edge Full support 79	Firefox Full support 46	IE No support No	Opera Full support Yes	Safari No support No	WebView Android Full support 43	Chrome Android Full support 43	Firefox Android Full support 46	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support 4.0
request Experimental'Non-standard'	Chrome Full support 46	Edge Full support 79	Firefox No support No	IE No support No	Opera ?	Safari No support No	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android No support No	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 5.0
requestAll Experimental'Non-standard'	Chrome Full support 48	Edge Full support 79	Firefox No support No	IE No support No	Opera ?	Safari No support No	WebView Android Full support 48	Chrome Android Full support 48	Firefox Android No support No	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 5.0
revoke Experimental'Non-standard'	Chrome Full support 46	Edge Full support 79	Firefox Full support 51 Disabled' Full support 51 Disabled' Disabled' From version 51: this feature is behind the dom.permissions.revoke.enable preference (needs to be set to true). To change preferences in Firefox, visit about:config. No support 47 — 51	IE No support No	Opera ?	Safari No support No	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 51 Disabled' Full support 51 Disabled' Disabled' From version 51: this feature is behind the dom.permissions.revoke.enable preference (needs to be set to true). To change preferences in Firefox, visit about:config. No support 47 — 51	Opera Android ?	Safari iOS No support No	Samsung Internet Android Full support 5.0

Legend

Full support  

Full support

No support  

No support

Compatibility unknown  

Compatibility unknown

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

Non-standard. Expect poor cross-browser support.'

Non-standard. Expect poor cross-browser support.

User must explicitly enable this feature.'

User must explicitly enable this feature.

Permissions by Mozilla Contributors is licensed under CC-BY-SA 2.5.