SerialPort: readable 屬性

可用性有限

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

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

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

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

SerialPort 介面的只讀屬性 readable 返回一個 ReadableStream,用於從連線到埠的裝置接收資料。從該流中讀取的塊是 Uint8Array 的例項。只要埠是開啟的並且沒有遇到致命錯誤,此屬性就非 null。

一個 ReadableStream

示例

以下示例顯示瞭如何從埠讀取資料。外部迴圈處理非致命錯誤,建立一個新的讀取器,直到遇到致命錯誤並且 readable 變為 null

js
while (port.readable) {
  const reader = port.readable.getReader();
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) {
        // |reader| has been canceled.
        break;
      }
      // Do something with |value|…
    }
  } catch (error) {
    // Handle |error|…
  } finally {
    reader.releaseLock();
  }
}

規範

規範
Web Serial API
# dom-serialport-readable

瀏覽器相容性