FeaturePolicy.getAllowlistForFeature()

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

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getAllowlistForFeature
Experimental
Chrome Full support 74
Full support 74
No support 69 — 73
Disabled
Disabled From version 69 until version 73 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.
Edge Full support 79Firefox Full support 65
Disabled
Full support 65
Disabled
Disabled From version 65: this feature is behind the dom.security.featurePolicy.webidl.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE No support NoOpera Full support 62
Full support 62
No support 56 — 62
Disabled
Disabled From version 56 until version 62 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled).
Safari No support NoWebView Android Full support 74Chrome Android Full support 74
Full support 74
No support 69 — 74
Disabled
Disabled From version 69 until version 74 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Full support 65
Disabled
Full support 65
Disabled
Disabled From version 65: this feature is behind the dom.security.featurePolicy.webidl.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 48
Disabled
Full support 48
Disabled
Disabled From version 48: this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled).
Safari iOS No support NoSamsung 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.