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

瀏覽器相容性