Serial: getPorts()-Methode
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, bevor Sie diese produktiv verwenden.
Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.
Die getPorts()
-Methode des Serial
-Interfaces gibt ein Promise
zurück, das mit einem Array von SerialPort
-Objekten aufgelöst wird. Diese Objekte repräsentieren serielle Ports, die mit dem Host verbunden sind und auf die der Ursprung Zugriff hat.
Syntax
getPorts()
Parameter
Keine.
Rückgabewert
Ein Promise
, das mit einem Array von SerialPort
-Objekten aufgelöst wird.
Ausnahmen
SecurityError
DOMException
-
Das zurückgegebene
Promise
wird mit diesem Fehler abgelehnt, wenn eine Permissions Policy die Nutzung dieser Funktion blockiert oder eine Benutzerberechtigungsaufforderung abgelehnt wurde.
Beispiele
Das folgende Beispiel verwendet getPorts()
, um eine Liste verfügbarer Ports zu initialisieren.
navigator.serial.getPorts().then((ports) => {
// Initialize the list of available ports with `ports` on page load.
});
Spezifikationen
Specification |
---|
Web Serial API # dom-serial-getports |
Browser-Kompatibilität
BCD tables only load in the browser