W3cubDocs

/Web APIs

FeaturePolicy: allowsFeature() method

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

The allowsFeature() method of the FeaturePolicy interface enables introspection of individual directives of the Permissions Policy it is run on. It returns a Boolean that is true if and only if the specified feature is allowed in the specified context (or the default context if no context is specified).

Syntax

js

const allowed = FeaturePolicy.allowsFeature(feature)

or

js

const allowed = FeaturePolicy.allowsFeature(feature, origin);

Parameters

Feature name

A specific feature name must be specified.

Origin name Optional

An origin URL to check the feature on. If it is omitted the default origin is used.

Return value

A Boolean that is true if and only if the feature is allowed.

Example

The following example queries whether or not the document is allowed to use camera API by the Permissions Policy. Please note that Camera API might be restricted by the Permissions API, if the user did not grant the corresponding permission yet.

js

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

// Then query feature for specific
const allowed = featurePolicy.allowsFeature("camera");

if (allowed) {
  console.log("FP allows camera.");
} else {
  console.log("FP does not allows camera.");
}

Specifications

No specification found

No specification data found for api.FeaturePolicy.allowsFeature.
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
allowsFeature 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/allowsFeature