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

浏览器兼容性