diff --git a/index.html b/index.html index 3ece9da..09d6fb0 100644 --- a/index.html +++ b/index.html @@ -393,8 +393,14 @@

- getGamepads + getGamepads()
+
+ If the current settings object's [=environment settings object + / responsible document=] is not allowed to use the "`gamepad`" + permission, then [=exception/throw=] a {{"SecurityError"}} + {{DOMException}}. +
Retrieve a snapshot of the data for the the currently connected and interacted-with gamepads. Gamepads MUST only appear in the list if @@ -733,10 +739,10 @@

User agents implementing this specification must provide a new DOM event, named gamepadconnected. The corresponding event - MUST be of type GamepadEvent and MUST fire on the - window object. Registration for and firing of the - gamepadconnected event MUST follow the usual behavior of - DOM Events. [[DOM]] + MUST be of type {{GamepadEvent}} and, if allowed to use the + "`gamepad`" permission, MUST fire on the window object. + Registration for and firing of the gamepadconnected event + MUST follow the usual behavior of DOM Events. [[DOM]]

A user agent MUST dispatch this event type to indicate the user @@ -752,8 +758,9 @@

User agents implementing this specification must provide a new DOM event, named gamepaddisconnected. The corresponding event - MUST be of type GamepadEvent and MUST fire on the - window object. Registration for and firing of the + MUST be of type GamepadEvent and, if allowed to use + the "`gamepad`" permission, MUST fire on the window + object. Registration for and firing of the gamepaddisconnected event MUST follow the usual behavior of DOM Events. [[DOM]]

@@ -776,6 +783,25 @@

button.

+
+

+ Integration with Permissions Policy +

+

+ This specification defines a policy-controlled feature identified by + the string "`gamepad`". Its default allowlist is '`self`'. +

+
+

+ A document’s [=Document/permissions policy=] determines + whether any content in that document is allowed to access + {{Navigator/getGamepads()}}. If disabled in any document, no content + in the document will be allowed to use + {{Navigator/getGamepads()}}, nor will the "gamepadconnected" and + "gamepaddisconnected" events fire. +

+
+

This specification defines conformance criteria that apply to a single