HIDDevice: receiveFeatureReport()-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 receiveFeatureReport()-Methode des HIDDevice-Interfaces empfängt einen Feature-Bericht vom HID-Gerät. Feature-Berichte sind ein Mittel, mit dem HID-Geräte und Anwendungen nicht standardisierte HID-Daten austauschen.

Die reportId für jedes der von diesem Gerät unterstützten Berichtsformate kann aus HIDDevice.collections abgerufen werden.

Syntax

js
receiveFeatureReport(reportId)

Parameter

reportId

Eine 8-Bit-Berichts-ID. Wenn das HID-Gerät keine Berichts-IDs verwendet, senden Sie 0.

Rückgabewert

Ein Promise, das mit einem DataView-Objekt aufgelöst wird, das den Feature-Bericht enthält.

Ausnahmen

NotAllowedError DOMException

Wird ausgelöst, wenn das Empfangen des Berichts aus irgendeinem Grund fehlschlägt.

Beispiele

Im folgenden Beispiel wird ein Bericht von einem Gerät mit einer reportId von 1 empfangen.

js
const dataView = await device.receiveFeatureReport(1);

Spezifikationen

Specification
WebHID API
# dom-hiddevice-receivefeaturereport

Browser-Kompatibilität

BCD tables only load in the browser