HIDDevice: open() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

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

open() 方法是 HIDDevice 介面的一部分,用於請求作業系統開啟 HID 裝置。

注意: HID 裝置不會自動開啟。因此,由 HID.requestDevice() 返回的 HIDDevice 物件必須使用此方法開啟,然後才能用於資料傳輸。

語法

js
open()

引數

無。

返回值

一個 Promise,在連線開啟後以 undefined 解析。

異常

InvalidStateError DOMException

如果連線已開啟,則丟擲此異常。

NotAllowedError DOMException

如果嘗試開啟連線因任何原因失敗,則丟擲此異常。

示例

在以下示例中,我們在嘗試傳送或接收資料之前,會等待 HID 連線開啟。

js
await device.open();

規範

規範
WebHID API
# dom-hiddevice-open

瀏覽器相容性