/
index.md
60 lines (41 loc) · 1.6 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
---
title: "FeaturePolicy: getAllowlistForFeature() method"
short-title: getAllowlistForFeature()
slug: Web/API/FeaturePolicy/getAllowlistForFeature
page-type: web-api-instance-method
status:
- experimental
browser-compat: api.FeaturePolicy.getAllowlistForFeature
---
{{APIRef("Feature Policy API")}}{{SeeCompatTable}}
The **`getAllowlistForFeature()`**
method of the {{DOMxRef("FeaturePolicy")}} interface enables querying of the allowlist for a specific feature for the current Permissions Policy.
## Syntax
```js-nolint
getAllowlistForFeature(feature)
```
### Parameter
- `feature`
- : The specific feature name to get its allowlist.
### 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](/en-US/docs/Web/API/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
{{Specifications}}
## Browser compatibility
{{Compat}}