Serial

Instanzmethoden

Serial.requestPort()

Gibt ein Promise zurck, das mit einer Instanz von SerialPort aufgelst wird, die das vom Benutzer gewhlte Gert reprsentiert. Diese Methode muss durch transiente Aktivierung aufgerufen werden.

Serial.getPorts()

Gibt ein Promise zurck, das mit einem Array von SerialPort-Objekten aufgelst wird, die die seriellen Ports reprsentieren, die mit dem Host verbunden sind und auf die der Ursprung Zugriff hat.

Ereignisse

Die folgenden Ereignisse sind fr Serial durch Event-Bubbling von SerialPort verfgbar:

SerialPort connect-Ereignis

Ein Ereignis, das ausgelst wird, wenn ein Port mit dem Gert verbunden wurde.

SerialPort disconnect-Ereignis

Ein Ereignis, das ausgelst wird, wenn ein Port vom Gert getrennt wurde.

Beispiele

Grundlegende Verwendung

Das folgende Beispiel zeigt, wie eine Website nach verfgbaren Ports suchen und dem Benutzer die Erlaubnis erteilen kann, zustzliche Ports zugnglich zu machen.

Beim Laden des Events werden Listener fr die connect- und disconnect-Ereignisse hinzugefgt, sodass die Website reagieren kann, wenn ein Gert mit dem System verbunden oder davon getrennt wird. Die Methode getPorts() wird dann aufgerufen, um festzustellen, welche Ports verbunden sind, auf die die Website bereits Zugriff hat.

Wenn die Website keinen Zugang zu verbundenen Ports hat, muss sie warten, bis sie eine Benutzeraktivierung erhlt, um fortzufahren. In diesem Beispiel verwenden wir einen click-Ereignishandler auf einem Button fr diese Aufgabe. Ein Filter wird an requestPort() mit einer USB-Hersteller-ID bergeben, um die dem Benutzer angezeigten Gerte auf USB-Gerte eines bestimmten Herstellers zu beschrnken.

navigator.serial.addEventListener("connect", (e) => {
  // Connect to `e.target` or add it to a list of available ports.
});

navigator.serial.addEventListener("disconnect", (e) => {
  // Remove `e.target` from the list of available ports.
});

navigator.serial.getPorts().then((ports) => {
  // Initialize the list of available ports with `ports` on page load.
});

button.addEventListener("click", () => {
  const usbVendorId = 0xabcd;
  navigator.serial
    .requestPort({ filters: [{ usbVendorId }] })
    .then((port) => {
      // Connect to `port` or add it to the list of available ports.
    })
    .catch((e) => {
      // The user didn't select a port.
    });
});

Spezifikationen

Browser-Kompatibilitt