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

瀏覽器相容性