HIDDevice.sendReport()

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The sendReport() method of the HIDDevice interface sends an output report to the HID device.

The reportId for each of the report formats that this device supports can be retrieved from HIDDevice.collections.

Syntax

HIDDevice.sendReport(reportId, data);

Parameters

reportId

An 8-bit report ID. If the HID device does not use report IDs, send 0.

data

Bytes as a BufferSource.

Return value

A Promise that resolves with undefined once the report has been sent.

Exceptions

DOMException NotAllowedError

Thrown if sending the report fails for any reason.

Examples

The example below shows how to make a Joy-Con device rumble using output reports. You can see more examples, and live demos in the article Connecting to uncommon HID devices.

// First, send a command to enable vibration.
// Magical bytes come from https://github.com/mzyy94/joycon-toolweb
const enableVibrationData = [1, 0, 1, 64, 64, 0, 1, 64, 64, 0x48, 0x01];
await device.sendReport(0x01, new Uint8Array(enableVibrationData));

// Then, send a command to make the Joy-Con device rumble.
// Actual bytes are available in the sample below.
const rumbleData = [ /* ... */ ];
await device.sendReport(0x10, new Uint8Array(rumbleData));

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
sendReport
89
89
No
No
75
No
No
No
No
No
No
No

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HIDDevice/sendReport