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, bevor Sie diese produktiv verwenden.

Hinweis: Dieses Feature ist verfügbar in Web Workers, außer in 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

BCD tables only load in the browser