This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.
The getAllowlistForFeature()
method of the FeaturePolicy
allows query of the allow list for a specific feature for the current Feature Policy.
Syntax
const allowlist = FeaturePolicy.getAllowlistForFeature(<feature>)
Parameter
Feature name
A specific feature name must be specified.
Return value
An Allow list for the specified feature.
Errors
The function will raise a warning if the specified Feature Policy directive name is not known. However, it will also return empty array, indicating that no origin is allowed to use the feature.
Example
The following example prints all the origins that are allowed to use Camera API by the Feature Policy. Please note that Camera API might be restricted by the Permissions API, if the user did not grant the corresponding permission yet.
// First, get the Feature Policy object
const featurePolicy = document.featurePolicy
// Then query feature for specific
const allowlist = featurePolicy.getAllowlistForFeature("camera")
for (const origin of allowlist) {
console.log(origin)
}
Specification
Specification | Status | Comment |
Permissions PolicyThe definition of 'getAllowlistForFeature' in that specification. | Editor's Draft | Initial definition. |
Browser compatibility
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 Full support 74 Full support 74 No support 69 — 73 Disabled' From version 69 until version 73 (exclusive): this feature is behind the |
Edge
Full support 79 |
Firefox Full support 65 Full support 65 Disabled' From version 65: this feature is behind the |
IE
No support No |
Opera Full support 62 Full support 62 No support 56 — 62 Disabled' From version 56 until version 62 (exclusive): this feature is behind the |
Safari
No support No |
WebView Android
Full support 74 |
Chrome Android Full support 74 Full support 74 No support 69 — 74 Disabled' From version 69 until version 74 (exclusive): this feature is behind the |
Firefox Android Full support 65 Full support 65 Disabled' From version 65: this feature is behind the |
Opera Android Full support 48 Full support 48 Disabled' From version 48: this feature is behind the |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
FeaturePolicy.getAllowlistForFeature() by Mozilla Contributors is licensed under CC-BY-SA 2.5.