This is an experimental technology
Check 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 |
---|---|---|
Permissions The 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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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 | 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 | 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 | Chrome Full support 46 | Edge Full support 79 | Firefox
Full support
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
| 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.