SerialPort: connected Eigenschaft

Wenn ein drahtloses Gerät außer Reichweite des Hosts gerät, wird jeder von einer Webanwendung geöffnete drahtlose Seriellport automatisch geschlossen, auch wenn er logisch verbunden bleibt. In solchen Fällen könnte die Webanwendung versuchen, den Port mithilfe von SerialPort.open() erneut zu öffnen.

Wenn jedoch das drahtlose Gerät absichtlich getrennt wurde (zum Beispiel, wenn der Benutzer sich entschieden hat, es über das Betriebssystem-Kontrollfeld zu trennen), sollte die Webanwendung davon absehen, den Port erneut zu öffnen, um eine Wiederverbindung mit dem drahtlosen Gerät zu vermeiden.

Das folgende Beispiel zeigt, wie die connected-Eigenschaft verwendet werden kann, um zwischen diesen beiden Fällen zu unterscheiden:

const ports = await navigator.serial.getPorts();
for (const port of ports) {
  if (port.connected) {
    // The port is logically connected
    // automatically try to reopen the port
    await port.open({ baudRate: 9600 });
  } else {
    // The port is not logically connected; at this point you could
    // prompt the user to make sure the Bluetooth device is available, and
    // Show a "connect" button to allow them to try opening the port if desired
  }
}

Ein boolescher Wert — true, wenn der Port logisch verbunden ist, und false, wenn nicht.

Das folgende Beispiel ruft Serial.requestPort() auf, wenn der Benutzer eine <button> drückt, und fordert ihn auf, einen seriellen Port auszuwählen, mit dem verbunden werden soll. Anschließend wird eine Meldung in der Konsole protokolliert, die den Verbindungsstatus meldet:

requestPortButton.addEventListener("click", async () => {
  const port = await navigator.serial.requestPort();
  console.log(`Requested serial port. Connected: ${port.connected}`);
});

Sie können das folgende Beispiel verwenden, um den Verbindungsstatus zu protokollieren, wenn die connect und disconnect-Ereignisse ausgelöst werden:

navigator.serial.addEventListener("connect", ({ target: port }) => {
  console.log(`Connect event fired. Connected: ${port.connected}`);
});

navigator.serial.addEventListener("disconnect", ({ target: port }) => {
  console.log(`Disconnect event fired. Connected: ${port.connected}`);
});