SerialPort: disconnect 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

注意:此功能在 專用 Web Workers 中可用。

SerialPort 介面的 disconnect 事件在埠與裝置斷開連線時觸發。

描述

更具體地說,當一個先前已 邏輯連線 的埠(在使用者授予網站訪問許可權後,在呼叫 Serial.requestPort() 後)不再連線時,就會觸發 disconnect 事件。

事件冒泡

此事件會冒泡到返回此介面的 Serial 例項。event.target 屬性指向冒泡上來的 SerialPort 物件。

有關更多資訊,請參閱 事件冒泡

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("disconnect", (event) => { })

ondisconnect = (event) => { }

事件型別

一個通用的 Event

示例

在特定埠斷開連線時通知

此處,事件監聽器安裝在特定的 SerialPort 物件上。

js
port.addEventListener("disconnect", (event) => {
  // notify that the port has become unavailable
});

監聽任何變為不可用的埠

disconnect 事件會冒泡到 Serial 物件,您可以在此處監聽任何變為不可用的埠。

js
navigator.serial.addEventListener("disconnect", (event) => {
  // notify that a port has become unavailable
  // use `event.target` to refer to the unavailable port
});

規範

規範
Web Serial API
# dfn-disconnect
Web Serial API
# dom-serialport-ondisconnect

瀏覽器相容性

另見