This is an experimental technology
Check 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, inditating that no origin is allowed to use the feature.
Example
The followin 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 corrsponding 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 |
---|---|---|
Feature Policy The definition of 'getAllowlistForFeature' in that specification. |
Editor's Draft | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getAllowlistForFeature | Chrome
Full support
74
| Edge Full support 79 | Firefox
Full support
65
| IE No support No | Opera
Full support
62
| Safari No support No | WebView Android Full support 74 | Chrome Android
Full support
74
| Firefox Android
Full support
65
| Opera Android
Full support
48
| 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.