HIDDevice: open() Methode

Limited availability

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

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Hinweis: This feature is available in Web Workers, except for Shared Web Workers.

Die open() Methode des HIDDevice Interfaces fordert das Betriebssystem auf, das HID-Gerät zu öffnen.

Hinweis: HID-Geräte werden nicht automatisch geöffnet. Daher muss ein HIDDevice, das von HID.requestDevice() zurückgegeben wird, mit dieser Methode geöffnet werden, bevor es zum Datentransfer zur Verfügung steht.

Syntax

js
open()

Parameter

Keine.

Rückgabewert

Ein Promise, der mit undefined aufgelöst wird, sobald die Verbindung geöffnet ist.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn die Verbindung bereits geöffnet ist.

NotAllowedError DOMException

Wird ausgelöst, wenn der Versuch, die Verbindung zu öffnen, aus irgendeinem Grund fehlschlägt.

Beispiele

Im folgenden Beispiel warten wir darauf, dass die HID-Verbindung geöffnet wird, bevor wir versuchen, Daten zu senden oder zu empfangen.

js
await device.open();

Spezifikationen

Specification
WebHID API
# dom-hiddevice-open

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.