HIDDevice: receiveFeatureReport() 方法

可用性有限

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

注意:此功能在 Web Workers 中可用,但 共享 Web Workers 除外。

HIDDevice 接口的 receiveFeatureReport() 方法用于从 HID 设备接收一个 feature report。Feature reports 是一种 HID 设备和应用程序之间交换非标准化 HID 数据的方式。

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

语法

js
receiveFeatureReport(reportId)

参数

reportId

一个 8 位报表 ID。如果 HID 设备不使用报表 ID,则发送 0

返回值

一个 Promise,它会解析为一个 DataView 对象,其中包含 feature report。

异常

NotAllowedError DOMException

如果由于任何原因接收报表失败,则会抛出此错误。

示例

在下面的示例中,使用 reportId 1 从设备接收报表。

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

规范

规范
WebHID API
# dom-hiddevice-receivefeaturereport

浏览器兼容性