USB: getDevices() 方法

有限可用性

此功能不是基线功能,因为它在一些最常用的浏览器中无法使用。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中可用。

USB 接口的 getDevices 方法返回一个 Promise,该方法将解析为一个 USBDevice 对象的数组,用于配对的已连接设备。有关配对设备的信息,请参阅 USB.requestDevice()

语法

js
getDevices()

参数

无。

返回值

一个 Promise,该方法将解析为一个 USBDevice 对象的数组。

示例

以下示例将配对设备的产品名称和序列号记录到控制台。有关配对设备的信息,请参阅 USB.requestDevice()

js
navigator.usb.getDevices().then((devices) => {
  console.log(`Total devices: ${devices.length}`);
  devices.forEach((device) => {
    console.log(
      `Product name: ${device.productName}, serial number ${device.serialNumber}`,
    );
  });
});

规范

规范
WebUSB API
# ref-for-dom-usb-getdevices②

浏览器兼容性

BCD 表仅在浏览器中加载