Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Serial: getPorts()-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 insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
Experimentell:Dies ist eineexperimentelle Technologie
Überprüfen Sie dieBrowser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Hinweis: Diese Funktion ist inDedicated Web Workers verfügbar.
DiegetPorts()-Methode derSerial-Schnittstelle gibt einPromise zurück, das mit einem Array vonSerialPort-Objekten aufgelöst wird. Diese repräsentieren die mit dem Host verbundenen seriellen Ports, auf die der Ursprung Zugriff hat.
Syntax
getPorts()Parameter
Keine.
Rückgabewert
EinPromise, das mit einem Array vonSerialPort-Objekten aufgelöst wird.
Ausnahmen
SecurityErrorDOMExceptionDas zurückgegebene
Promisewird in einer der folgenden Situationen mit diesem Fehler abgelehnt:- Eine
serialPermissions Policy blockiert die Nutzung dieser Funktion. - Eine Benutzerberechtigungsanfrage wurde abgelehnt.
- Eine
Beispiele
Das folgende Beispiel verwendetgetPorts(), 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 |