USB.getDevices()

Limited availability

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

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

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

USB インターフェイスの getDevices メソッドは、接続されたペア設定済みのデバイスを表す USBDevice の配列で解決する Promise を返します｡デバイスのペア設定については、USB.requestDevice() を参照してください。

構文

js
getDevices()

引数

なし

返値

USBDevice オブジェクトの配列で解決する Promise です。

例

以下の例では、ペア設定済みのデバイスの製品名とシリアル番号をコンソールに出力します。デバイスのペア設定については、USB.requestDevice() を参照してください。

js
navigator.usb.getDevices().then((devices) => {
  console.log(`デバイス数: ${devices.length}`);
  devices.forEach((device) => {
    console.log(
      `製品名: ${device.productName} シリアル番号 ${device.serialNumber}`,
    );
  });
});

仕様書

Specification
WebUSB API
# ref-for-dom-usb-getdevices②

ブラウザーの互換性

BCD tables only load in the browser