SerialPort.readable

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

SerialPort の読み取り専用プロパティ readable は、ポートに接続されたデバイスからデータを受信する用の ReadableStream を返します。このストリームから読み出せるチャンクは、Uint8Array のインスタンスです。このプロパティは、ポートが開かれており、かつ致命的なエラーが起きていない限り、null にはなりません。

値

ReadableStream です。

例

この例は、ポートからデータを受信する方法を示します。外側のループは致命的なエラーが発生して readable が null になるまで新しい reader を生成し続けることで、致命的でないエラーを処理します。

js
while (port.readable) {
  const reader = port.readable.getReader();
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) {
        // |reader| がキャンセルされました。
        break;
      }
      // |value| について何かをする
    }
  } catch (error) {
    // |error| を処理する
  } finally {
    reader.releaseLock();
  }
}

仕様書

Specification
Web Serial API
# dom-serialport-readable

ブラウザーの互換性

BCD tables only load in the browser