USB: getDevices()-Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die getDevices-Methode des USB-Interfaces gibt ein Promise zurück, das mit einem Array von USBDevice-Objekten für gepaarte, angeschlossene Geräte auflöst. Für Informationen über das Koppeln von Geräten siehe USB.requestDevice().

Syntax

js
getDevices()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem Array von USBDevice-Objekten auflöst.

Beispiele

Das folgende Beispiel protokolliert den Produktnamen und die Seriennummer der gepaarten Geräte in der Konsole. Für Informationen über das Koppeln von Geräten siehe 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}`,
    );
  });
});

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser