SerialPort: getInfo()-Methode

Limited availability

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

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

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

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

Die getInfo()-Methode des SerialPort-Interfaces gibt ein Objekt zurück, das Identifikationsinformationen für das über den Port verfügbare Gerät enthält.

Syntax

js
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.

html
<button id="connect">Connect</button>
js
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

Specification
Web Serial API
# dom-serialport-getinfo

Browser-Kompatibilität

BCD tables only load in the browser