HIDDevice.open()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
HIDDevice
の open()
メソッドは、オペレーティングシステムに HID デバイスを開くことを要求します。
メモ:
HID デバイスは自動では開かれません。そのため、HID.requestDevice()
から返された HIDDevice
でデータの転送を可能にするには、このメソッドを用いて開く必要があります。
構文
js
open()
引数
なし。
返値
接続が開かれたら undefined
で解決する Promise
を返します。
例外
InvalidStateError
DOMException
-
接続が既に開かれているとき投げられます。
NotAllowedError
DOMException
-
何らかの理由により接続を開くのに失敗したとき投げられます。
例
この例では、データの送受信を試みる前に HID 接続を開くのを待ちます。
js
await device.open();
仕様書
Specification |
---|
WebHID API # dom-hiddevice-open |
ブラウザーの互換性
BCD tables only load in the browser