HIDDevice.receiveFeatureReport()

Secure context

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

The receiveFeatureReport() method of the HIDDevice interface receives a feature report from 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.receiveFeatureReport(reportId);

Parameters

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

Return value

A Promise which resolves with a DataView object containing the feature report.

Exceptions

DOMException NotAllowedError
Thrown if receiving the report fails for any reason.

Examples

In the following example a report is received from a device using a reportId of 1.

const dataView = await device.receiveFeatureReport(1);

Specifications

Specification
WebHID API
# dom-hiddevice-receivefeaturereport

Browser compatibility

BCD tables only load in the browser