W3cubDocs

/Web APIs

FeaturePolicy: getAllowlistForFeature() method

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The getAllowlistForFeature() method of the FeaturePolicy interface enables querying of the allowlist for a specific feature for the current Permissions Policy.

Syntax

js

const allowlist = FeaturePolicy.getAllowlistForFeature(feature)

Parameter

Feature name

A specific feature name must be specified.

Return value

An array of strings containing the serialized list of allowed origins for the feature. If a wildcard (*) is used, the array will contain *.

Errors

The function will raise a warning if the specified Permissions 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 Permissions Policy. Please note that Camera API might also be restricted by the Permissions API, if the user did not grant the corresponding permission.

js

// First, get the FeaturePolicy object
const featurePolicy = document.featurePolicy;

// Query for specific feature
const allowlist = featurePolicy.getAllowlistForFeature("camera");

for (const origin of allowlist) {
  console.log(origin);
}

Specifications

No specification found

No specification data found for api.FeaturePolicy.getAllowlistForFeature.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
getAllowlistForFeature 74 79 65 No 62 No 74 74 No 53 No 11.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FeaturePolicy/getAllowlistForFeature