【Node.js24.x】TransformStream::TransformStream()関数の使い方

TransformStream関数は、Node.jsのWeb Streams APIに準拠し、データの読み込みと書き込みの間に変換処理を挿入するストリーム変換オブジェクトを生成するための関数です。この関数によって生成されるTransformStreamは、内部的に読み取り可能なストリーム（ReadableStream）と書き込み可能なストリーム（WritableStream）を連結し、その間でデータを加工・変換する機能を提供します。

システムにおいて、あるソースからデータを受け取り、それを別の形式に変換して、最終的な目的地へ送る必要が生じる場面は多々あります。例えば、ファイルから読み込んだテキストデータを大文字に変換したり、画像データを別のフォーマットに変換したり、あるいはデータを暗号化したりといった処理です。TransformStreamは、このようなデータの流れを中断することなく、効率的かつ非同期的に変換を実行することを可能にします。

開発者は、TransformStream関数を使用する際に、データの変換方法を定義するカスタムロジックを実装することで、特定の要件に合わせたストリーム変換処理を作成できます。これにより、データの入出力パイプラインにおいて、変換処理を明確に分離し、モジュール化された再利用しやすいコードを書くことが可能になります。特に、大規模なデータ処理やリアルタイムでのデータ加工が必要なシステムにおいて、TransformStreamはデータの流れを管理し、効率的な処理を実現するための基盤となる重要な要素です。

Copy
1new TransformStream({
2  transform(chunk, controller) {
3    controller.enqueue(chunk);
4  }
5});

transformer = {}, writableStrategy = {}, readableStrategy = {}

• transformer: object: データを変換するためのオブジェクト
• writableStrategy: object: 書き込みストリームの戦略を指定するオブジェクト
• readableStrategy: object: 読み込みストリームの戦略を指定するオブジェクト

TransformStream

TransformStream クラスのコンストラクターで、新しい TransformStream インスタンスを生成します。このインスタンスは、データの変換処理をストリームとして扱うための機能を提供します。