HIDDevice：receiveFeatureReport() 方法

可用性有限

此功能不是基线功能，因为它在一些最广泛使用的浏览器中不起作用。

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中。

实验性：这是一个实验性技术
在生产环境中使用此功能之前，请仔细查看浏览器兼容性表。

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

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

语法

js
receiveFeatureReport(reportId)

参数

reportId

一个 8 位的报告 ID。如果 HID 设备不使用报告 ID，则发送0。

返回值

一个Promise，它解析为一个包含功能报告的DataView对象。

异常

NotAllowedError DOMException

如果由于任何原因接收报告失败，则抛出此异常。

示例

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

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

规范

规范
WebHID API
# dom-hiddevice-receivefeaturereport

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。