ReadableStream DefaultReader

リーダーは、ReadableStream の出力を WritableStream へパイプするのではなく、ストリームから読み取りたいときに使います。

ReadableStreamDefaultReader はコンストラクターではインスタンス化しません。ReadableStream から取得します。

const { readable, writable } = new TransformStream();
const reader = readable.getReader();

• reader.closed : Promise

  • リーダーが閉じているかどうかを示す Promise です。リーダーストリームが閉じると履行され、ストリームにエラーがあると拒否されます。

• read() : Promise

  • リーダーキューを通る次の利用可能なデータチャンクを返す Promise です。

• cancel(reasonstringoptional) : void

  • ストリームをキャンセルします。reason は、キャンセル理由を示す任意の人間可読な文字列です。reason は基盤ソースの cancel アルゴリズムに渡されます。この readable ストリームが TransformStream の一方である場合、cancel アルゴリズムにより transform の writable 側が reason でエラー状態になります。

• releaseLock() : void

  • readable ストリームのロックを解除します。リーダーに未完了の読み取り操作がある場合、ロックは解除できません。TypeError がスローされ、リーダーはロックされたままです。

• Streams
• WHATWG Streams API 仕様の Readable streams ↗