コンテンツにスキップ

ReadableStream DefaultReader

背景

リーダーは、ReadableStreamから読み取る必要があるときに使用されます。出力をWritableStreamにパイプするのではなく。

ReadableStreamDefaultReaderは、そのコンストラクタを介してインスタンス化されることはありません。むしろ、ReadableStreamから取得されます:

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

プロパティ

  • reader.closed : Promise

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

メソッド

  • read() : Promise

    • リーダーキューを通過している次の利用可能なデータチャンクを返すPromiseです。
  • cancel(reasonstringoptional) : void

    • ストリームをキャンセルします。reasonはキャンセルの理由を示すオプションの人間が読める文字列です。reasonは、基盤となるソースのキャンセルアルゴリズムに渡されます — この読み取り可能ストリームがTransformStreamの一側である場合、そのキャンセルアルゴリズムは変換の書き込み側をreasonでエラー状態にします。
  • releaseLock() : void

    • 読み取り可能ストリームのロックを解除します。リーダーに保留中の読み取り操作がある場合、ロックを解除することはできません。TypeErrorがスローされ、リーダーはロックされたままになります。

関連リソース