FeaturePolicy.getAllowlistForFeature()

Experimental

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, 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)
}

Specifications

Specification Status Comment
Permissions Policy
The definition of 'getAllowlistForFeature' in that specification.
Editor's Draft Initial definition.

Browser compatibility

BCD tables only load in the browser