串口:可读属性

安全上下文:此功能仅在 安全上下文 (HTTPS) 中可用,在某些或所有 支持的浏览器 中可用。

实验性:这是一个 实验性技术
在生产环境中使用之前,请仔细检查 浏览器兼容性表

注意:此功能在 专用 Web 工作线程 中可用。

readableSerialPort 接口的只读属性返回一个 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 串行 API
# dom-serialport-readable

浏览器兼容性

BCD 表格仅在浏览器中加载