-
Notifications
You must be signed in to change notification settings - Fork 4
/
index.html
276 lines (276 loc) · 7.24 KB
/
index.html
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>
Powerful Features Registry
</title>
<script src="https://www.w3.org/Tools/respec/respec-w3c" async class="remove"></script>
<script class="remove">
// All config options at https://respec.org/docs/
var respecConfig = {
shortName: "powerful-features-registry",
group: "webappsec",
specStatus: "DRY",
latestVersion: null,
editors: [
{
name: "Marcos Cáceres",
url: "https://www.w3.org/",
company: "W3C",
companyURL: "https://www.w3.org/",
w3cid: "39125",
},
{
name: "Mike Taylor",
url: "https://miketaylr.com/posts/",
companyURL: "https://google.com/",
company: "Google LLC",
w3cid: "90704",
},
],
github: {
branch: "main",
repoURL: "w3c/powerful-features-registry",
},
xref: "web-platform",
};
</script>
</head>
<body data-cite="permissions permissions-policy">
<section id="abstract">
<p>
This document serves as the official registry of [=powerful features=] of the web platform,
providing a centralized place to find these features.
</p>
</section>
<section id="sotd">
<p>
The list of features in this registry is not exhaustive. It is expected that new features
will be added to this document as they are implemented across multiple user agents.
</p>
<p>
Please subscribe to the <a href="https://github.com/w3c/permissions-registry/">Powerful
Features Registry Repository</a> on GitHub to be notified of changes.
</p>
</section>
<section>
<h2>
Change Process
</h2>
<p>
The process for adding and/or updating a [=powerful feature=] in this registry is as
follows:
</p>
<ol>
<li>Determine if your feature meets the definition of a [=powerful feature=] (i.e.,
requires [=express permission=] to be used).
</li>
<li>[=Specify a powerful feature=] in your specification in conformance with the
[[[Permissions]]] specification.
</li>
<li>Modify the [=table of powerful features=]. In the first column, add the token string
that identifies the [=powerful feature=]'s [=powerful feature/name=]. In the second column,
add the shortname of the specification that specifies the feature.
</li>
<li>Submit a pull request to the <a href=
"https://github.com/w3c/powerful-features-registry/">Powerful Features Registry
Repository</a> on GitHub with your changes. The maintainers of the repository will review
your pull request and check that everything integrates properly.
</li>
</ol>
</section>
<section>
<h2>
Registry table of powerful features
</h2>
<p>
[=Powerful features=] are identified by a unique string token, which is used for
integration with the [[[Permissions]]] and [[[Permissions-Policy]]] specifications.
</p>
<aside class="note" title="Permissions and Permissions Policy">
<p>
Not every [=policy-controlled feature=] is [=powerful features=]. For example,
"web-share" is a [=policy-controlled feature=] that is not classified as a [=powerful
feature=] because it doesn't require [=express permission=] to be used.
However, by design, every [=powerful feature=] is a [=policy-controlled feature=]. For
example, "geolocation" is both a [=policy-controlled feature=] and a [=powerful
feature=], as it requires [=express permission=] to be used. Please refer to the
[[[Permissions]]] specification for guidance on how to specify a powerful feature.
</p>
</aside>
<aside class="advisement">
<p>
Being listed in the table below does not imply that a [=user agent=] supports a
[=powerful feature=].
</p>
</aside>
<table class="data">
<caption>
<dfn data-local-lt="Table of powerful features">Table of powerful features of the web
platform</dfn>
</caption>
<tr>
<th>
Unique token that identifies the powerful feature
</th>
<th>
Specification that defines the powerful feature
</th>
</tr>
<tr>
<td>
"accelerometer"
</td>
<td>
[[[accelerometer]]]
</td>
</tr>
<tr>
<td>
"ambient-light-sensor"
</td>
<td>
[[[ambient-light]]]
</td>
</tr>
<tr>
<td>
"background-fetch"
</td>
<td>
[[[background-fetch]]]
</td>
</tr>
<tr>
<td>
"background-sync"
</td>
<td>
[[[web-background-sync]]]
</td>
</tr>
<tr>
<td>
"bluetooth"
</td>
<td>
[[[web-bluetooth]]]
</td>
</tr>
<tr>
<td>
"camera"
</td>
<td>
[[[mediacapture-streams]]]
</td>
</tr>
<tr>
<td>
"display-capture"
</td>
<td>
[[[screen-capture]]]
</td>
</tr>
<tr>
<td>
"geolocation"
</td>
<td>
[[[geolocation]]]
</td>
</tr>
<tr>
<td>
"gyroscope"
</td>
<td>
[[[gyroscope]]]
</td>
</tr>
<tr>
<td>
"magnetometer"
</td>
<td>
[[[magnetometer]]]
</td>
</tr>
<tr>
<td>
"microphone"
</td>
<td>
[[[mediacapture-streams]]]
</td>
</tr>
<tr>
<td>
"midi"
</td>
<td>
[[[webmidi]]]
</td>
</tr>
<tr>
<td>
"nfc"
</td>
<td>
[[[web-nfc]]]
</td>
</tr>
<tr>
<td>
"notifications"
</td>
<td>
[[[notifications]]]
</td>
</tr>
<tr>
<td>
"persistent-storage"
</td>
<td>
[[[storage]]]
</td>
</tr>
<tr>
<td>
"push"
</td>
<td>
[[[push-api]]]
</td>
</tr>
<tr>
<td>
"screen-wake-lock"
</td>
<td>
[[[screen-wake-lock]]]
</td>
</tr>
<tr>
<td>
"speaker-selection"
</td>
<td>
[[[audio-output]]]
</td>
</tr>
<tr>
<td>
"xr-spatial-tracking"
</td>
<td>
[[[webxr]]]
</td>
</tr>
</table>
</section>
</body>
</html>