変換ストリームまたはその他の書き込み可能/読み取り可能なペアを介して現在のストリームをパイプするチェーン可能な方法を提供します。→●、MS

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

ストリームをパイプすると、通常、パイプしている間はストリームがロックされ、他のリーダーがロックできなくなります。

readableStream

ReadableStream。

transformStream

読み取り可能なストリームと書き込み可能なストリームで構成され、データをある形式から別の形式に変換する TransformStream（または構造 {writable, readable} のオブジェクト）。

書き込み可能なストリーム（writable stream）に書き込まれたデータは、読み取り可能なストリーム（readable stream）によって何らかの変換された状態で読み取ることができます。例えば、TextDecoder ではバイトが書き込まれ、そこから文字列が読み取られ、動画デコーダーではエンコードされたバイトが書き込まれ、非圧縮動画フレームが読み取られます。

options 省略可

書き込み可能なストリーム（writable stream）にパイプするときに使用するオプション。pipeTo(writable, options) のような呼び出しで使用されます。

戻り値

transformStream の readable 側。

例外

TypeError

transformStream の writable および／または readable プロパティは未定義です。

例

// 元の画像をフェッチ
fetch('png-logo.png')
// その body を ReadableStream として取得
.then(response => response.body)
.then(rs => logReadableStream('Fetch Response Stream', rs))
// 元の画像からグレースケール PNG ストリームを作成
.then(body => body.pipeThrough(new PNGTransformStream()))
.then(rs => logReadableStream('PNG Chunk Stream', rs))

テスト