【Node.js24.x】Object::TransformStream()メソッドの使い方

TransformStreamメソッドは、Node.js環境におけるデータの変換処理をストリームとして実行するメソッドです。これは、入力ストリームからデータを受け取り、それを加工した上で出力ストリームに渡すという一連の操作を効率的に行うために設計されています。例えば、ファイルから読み込んだデータを圧縮したり、特定の形式に変換したりする際に利用されます。このメソッドは、Readableストリームから読み込まれたデータをWritableストリームに書き出す際の中間処理として機能し、データの流れを中断することなくリアルタイムでの加工処理を可能にします。これにより、メモリ使用量を抑えながら大規模なデータを扱うことができ、非同期処理を容易に記述することが可能です。開発者は、このメソッドを通じて、データ変換ロジックに集中し、ストリームの複雑な連携を意識することなく、簡潔なコードで堅牢なシステムを構築できます。

Copy
1const transformStream = new TransformStream({
2  transform(chunk, controller) {
3    // 受け取ったデータチャンク (chunk) を変換し、controller.enqueue() で出力ストリームに渡します。
4    // 例: 受け取ったデータを文字列として大文字に変換して出力
5    controller.enqueue(String(chunk).toUpperCase());
6  }
7});

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

• transformer: object: データの変換処理を定義したオブジェクト
• writableStrategy: object: 書き込みストリームの戦略を定義したオブジェクト
• readableStrategy: object: 読み込みストリームの戦略を定義したオブジェクト

TransformStream

TransformStreamメソッドは、新しいTransformStreamオブジェクトを生成して返します。このオブジェクトは、データを変換するためのストリーム操作を定義します。