SerialPort: getInfo() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Die getInfo() Methode der SerialPort Schnittstelle gibt ein Objekt zurück, das identifizierende Informationen für das über den Port verfügbare Gerät enthält.
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 eine positive Ganzzahl, die den Hersteller des Geräts identifiziert. Andernfalls ist sie
undefined. usbProductId-
Wenn der Port Teil eines USB-Geräts ist, ist diese Eigenschaft eine positive Ganzzahl, die das USB-Gerät identifiziert. Andernfalls ist sie
undefined. bluetoothServiceClassId-
Wenn der Port ein Bluetooth RFCOMM-Dienst ist, ist diese Eigenschaft eine positive Ganzzahl oder ein String, der die Bluetooth-Dienstklassenspezifikation des Geräts darstellt. Wenn nicht, ist sie
undefined.
Beispiele
Informationen von einem ausgewählten Gerät abrufen
Dieser Codeausschnitt ruft die Serial.requestPort() Methode 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 zu erhalten.
<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", async () => {
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
| Spezifikation |
|---|
| Web Serial API # dom-serialport-getinfo |