HIDInputReportEvent
WebHID APIwindowandworkerexceptshared
WebHID APIwindow_and_worker_except_shared
The HIDInputReportEvent interface of the WebHID API is passed to inputreport event of HIDDevice when an input report is received from any associated HID device.
Instance properties
This interface also inherits properties from Event.
- HIDInputReportEvent.data
- : A DataView containing the data from the input report, excluding the
reportIdif the HID interface uses report IDs. - HIDInputReportEvent.device
- : The HIDDevice instance that represents the HID interface that sent the input report.
- HIDInputReportEvent.reportId
- : The one-byte identification prefix for this report, or 0 if the HID interface does not use report IDs.
Instance methods
This interface inherits methods from its parent, Event.
Examples
The following example demonstrates listening for an inputReport that will allow the application to detect which button is pressed on a Joy-Con Right device. You can see more examples, and live demos in the article Connecting to uncommon HID devices.
device.addEventListener("inputreport", (event) => {
const { data, device, reportId } = event;
// Handle only the Joy-Con Right device and a specific report ID.
if (device.productId !== 0x2007 && reportId !== 0x3f) return;
const value = data.getUint8(0);
if (value === 0) return;
const someButtons = { 1: "A", 2: "X", 4: "B", 8: "Y" };
console.log(`User pressed button ${someButtons[value]}.`);
});