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
allowsFeature(feature)
allowsFeature(feature, origin)
Parameters
feature-
The specific feature name to check its availability.
originOptional-
The specific origin name to check its availability. If not specified, the default origin will be 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.
// 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
This feature does not appear to be defined in any specification.Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
allowsFeature
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- User must explicitly enable this feature.