HIDDevice.receiveFeatureReport()

Limited availability

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

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

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

HIDDevice インターフェイスの receiveFeatureReport() メソッドは、HID レポートから Feature レポートを受信します。Feature レポートは、HID デバイスとアプリケーションが標準化されていない HID データを交換するための方法です。

各レポート形式用にデバイスがサポートしている reportId は、HIDDevice.collections から取得できます。

構文

js
receiveFeatureReport(reportId)

引数

reportId

8 ビットのレポート ID です。HID デバイスがレポート ID を使わない場合、0 を送信します。

返値

Feature レポートが入った DataView オブジェクトで解決する Promise を返します。

例外

NotAllowedError DOMException

何らかの理由でレポートの受信に失敗したとき投げられます。

この例では、reportId の値 1 を用いてデバイスからレポートを受信します。

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

仕様書

Specification
WebHID API
# dom-hiddevice-receivefeaturereport

ブラウザーの互換性

BCD tables only load in the browser