HIDDevice.open()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

HIDDeviceopen() メソッドは、オペレーティングシステムに 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