HID.getDevices()

Limited availability

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

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

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

HID インターフェイスの getDevices() メソッドは、ユーザーがこれまでに requestDevice() の呼び出しに応じてアクセスを許可した接続中の HID デバイスのリストを取得します。

構文

js
getDevices()

引数

なし。

返値

HIDDevice オブジェクトのリストで解決する Promise を返します。

例

この例では、デバイスのリストを取得し、デバイス名をコンソールに出力します。

js
document.addEventListener("DOMContentLoaded", async () => {
  let devices = await navigator.hid.getDevices();
  devices.forEach((device) => {
    console.log(`HID: ${device.productName}`);
  });
});

仕様書

Specification
WebHID API
# dom-hid-getdevices

ブラウザーの互換性

BCD tables only load in the browser