USB: getDevices() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

USB 接口的 getDevices 方法返回一个 Promise,该 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
# dom-usb-getdevices

浏览器兼容性