Skip to content

Add vendorId, productId, name attributes #202

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nondebug wants to merge 5 commits into
base: gh-pages
Choose a base branch
from
Open

Add vendorId, productId, name attributes #202

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
5d4f9b2
Add vendorId, productId, name attributes
nondebug Apr 27, 2024
a89e1fd
Update index.html
nondebug May 10, 2024
82c1cd4
Update index.html
nondebug May 10, 2024
16e05c9
Merge branch 'gh-pages' into vendor-product-name
marcoscaceres Jun 12, 2025
54359eb
Merge branch 'gh-pages' into vendor-product-name
marcoscaceres Jul 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,9 @@ <h2>
[Exposed=Window]
interface Gamepad {
readonly attribute DOMString id;
readonly attribute unsigned short? vendorId;
Comment thread
marcoscaceres marked this conversation as resolved.
readonly attribute unsigned short? productId;
Comment thread
marcoscaceres marked this conversation as resolved.
readonly attribute DOMString name;
readonly attribute long index;
readonly attribute boolean connected;
readonly attribute DOMHighResTimeStamp timestamp;
Expand Down Expand Up @@ -606,6 +609,47 @@ <h2>
{{Gamepad/id}} string.
</p>
</dd>
<dt>
<dfn>vendorId</dfn> attribute
</dt>
<dd>
<p>
The 16-bit identifier assigned to the device vendor by the USB
Implementers Forum or Bluetooth Special Interest Group, or `null`
if the gamepad has no vendor identifier or it is not available.
</p>
<p>
The [=user agent=] MAY set {{Gamepad/vendorId}} and
{{Gamepad/productId}} to `null` to mitigate the risk of exposing
device identifiers. If one of {{Gamepad/vendorId}} or
{{Gamepad/productId}} is `null` then both MUST be `null`.
</p>
</dd>
<dt>
<dfn>productId</dfn> attribute
</dt>
<dd>
The product identifier assigned by the device vendor, or `null` if
the gamepad has no product identifier or it is not available.
</dd>
<dt>
<dfn>name</dfn> attribute
</dt>
<dd>
<p>
A human-readable identifier for the gamepad. The exact content of
the {{Gamepad/name}} string is left unspecified. The [=user agent=]
MAY use a product name string provided by the device firmware. The
{{Gamepad/name}} MUST NOT be the empty string and MUST NOT include
unique identifiers like serial numbers or Bluetooth device
Comment thread
marcoscaceres marked this conversation as resolved.
addresses.
</p>
<p class="note">
The {{Gamepad/name}} is intended only as a user-facing identifier.
It is not a stable identifier and might change over time due to
updates to the device firmware, browser, or operating system.
</p>
</dd>
<dt>
<dfn>index</dfn> attribute
</dt>
Expand Down Expand Up @@ -1016,6 +1060,21 @@ <h3>
<li>Initialize |gamepad|'s {{Gamepad/id}} attribute to an
identification string for the gamepad.
</li>
<li>Initialize |gamepad|.{{Gamepad/vendorId}} to `null`</li>
<li>Initialize |gamepad|.{{Gamepad/productId}} to `null`.</li>
<li>If the gamepad has vendor and product identifiers:
<ol>
<li>Set |gamepad|.{{Gamepad/vendorId}} to the vendor
identifier.
</li>
<li>Set |gamepad|.{{Gamepad/productId}} to the product
identifier.
</li>
</ol>
</li>
<li>Initialize |gamepad|'s {{Gamepad/name}} attribute to a
human-readable identifier for the gamepad.
</li>
<li>Initialize |gamepad|'s {{Gamepad/index}} attribute to the
result of [=selecting an unused gamepad index=] for |gamepad|.
</li>
Expand Down