HIDDevice.sendFeatureReport()

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

The sendFeatureReport() method of the HIDDevice interface sends a feature report to the HID device. Feature reports are a way for HID devices and applications to exchange non-standardized HID data.

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

Syntax

HIDDevice.sendFeatureReport(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

In the following example sendFeatureReport() makes a device blink. You can see more examples and live demos in the article Connecting to uncommon HID devices.

const reportId = 1;
for (let i = 0; i < 10; i++) {
  // Turn off
  await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
  await waitFor(100);
  // Turn on
  await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
  await waitFor(100);
}

Specifications

Specification
WebHID API
# dom-hiddevice-sendfeaturereport

Browser compatibility

BCD tables only load in the browser