SerialPort: Methode getInfo()
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 mit den folgenden Eigenschaften:
usbVendorId-
Wenn der Port Teil eines USB-Geräts ist, ist diese Eigenschaft eine unsignierte kurze 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 unsignierte kurze Ganzzahl, die das USB-Gerät identifiziert. Andernfalls ist sie
undefined. bluetoothServiceClassId-
Wenn der Port ein Bluetooth RFCOMM-Dienst ist, ist diese Eigenschaft eine unsignierte lange Ganzzahl oder ein String, der die Bluetooth-Service-Klassen-ID des Geräts darstellt. Andernfalls ist sie
undefined.
Beispiel
Dieser Codeausschnitt 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
| Spezifikation |
|---|
| Web Serial API # dom-serialport-getinfo |