SerialPort: getInfo()-Methode

Syntax

getInfo()

Parameter

Keine.

Rückgabewert

Ein Objekt, das die folgenden Eigenschaften enthält:

usbVendorId

Wenn der Port Teil eines USB-Geräts ist, ist diese Eigenschaft ein nicht signiertes kurzes Integer, das den Anbieter des Geräts identifiziert. Andernfalls ist es undefined.

usbProductId

Wenn der Port Teil eines USB-Geräts ist, ist diese Eigenschaft ein nicht signiertes kurzes Integer, das das USB-Gerät identifiziert. Andernfalls ist es undefined.

bluetoothServiceClassId Experimentell

Wenn der Port ein Bluetooth-RFCOMM-Dienst ist, ist diese Eigenschaft ein nicht signiertes langes Integer oder eine Zeichenkette, die die Bluetooth-Dienstklassen-ID des Geräts darstellt. Andernfalls ist es undefined.

Beispiel

Dieses Snippet ruft die Methode Serial.requestPort() auf, wenn ein <button> gedrückt wird. Wir übergeben einen Filter an requestPort(), um nach Arduino Uno USB-Geräten zu filtern. Sobald ein Port angefordert wird, rufen wir getInfo() auf, um die usbProductId und usbVendorId des Geräts zurückzugeben.

<button id="connect">Connect</button>

const connectBtn = document.getElementById("connect");

// Filter for devices with the Arduino Uno USB Vendor/Product IDs
const filters = [
  { usbVendorId: 0x2341, usbProductId: 0x0043 },
  { usbVendorId: 0x2341, usbProductId: 0x0001 }
];

connectBtn.addEventListener("click", () => {
  try {
    // Prompt the user to select an Arduino Uno device
    const port = await navigator.serial.requestPort({ filters });

    // Return the device's identifying info
    const { usbProductId, usbVendorId } = port.getInfo();
  } catch (e) {
    // The user didn't select a device
  }
});

Spezifikationen

Browser-Kompatibilität