HIDDevice：receiveFeatureReport() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

备注： 此特性在 Web Worker（不包括共享 Web Worker）中可用。

HIDDevice 接口的 receiveFeatureReport() 方法用于从 HID 设备接收功能报告。功能报告是 HID 设备和应用程序之间交换非标准化 HID 数据的一种方式。

可以从 HIDDevice.collections 中检索此设备支持的每种报告格式的 reportId。

语法

js
receiveFeatureReport(reportId)

参数

reportId

一个 8 位的报告 ID。如果设备不使用报告 ID，则返回 0。

返回值

一个 Promise，兑现为包含功能报告的 DataView 对象。

异常

NotAllowedError DOMException

如果因任何原因尝试接收报告失败，则抛出异常。

示例

以下示例中，使用 reportId 为 1 从设备接收报告。

js
const dataView = await device.receiveFeatureReport(1);

规范

Specification
WebHID API
# dom-hiddevice-receivefeaturereport

浏览器兼容性

BCD tables only load in the browser