【Node.js24.x】TextDecoderStream::TextDecoderStream()関数の使い方
TextDecoderStream関数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
TextDecoderStream関数は、バイトデータストリームをテキストデータストリームに変換するプロセスを実行する関数です。この関数を呼び出すことで、Web Streams APIの一部であるTextDecoderStreamクラスの新しいインスタンスを生成します。
具体的には、入力として受け取ったReadableStreamから、UTF-8などの指定されたエンコーディング形式のバイトデータを読み込み、それをJavaScriptの文字列として表現されるテキストデータにデコードします。デコードされたテキストデータは、別のReadableStreamとして出力されます。これにより、ストリーム処理において、ネットワーク経由で受信したバイナリデータや、ファイルから読み込んだバイトデータを、開発者が扱いやすいテキスト形式で逐次的に処理することが可能になります。
例えば、HTTPレスポンスのボディが圧縮されたり暗号化されていない限り、通常はテキストデータですが、ネットワーク上ではバイトデータとして送られてきます。TextDecoderStreamを使用すると、このバイトデータを効率的に読み込みながら、指定された文字コードでリアルタイムにテキストへ変換し、次の処理へパイプで渡すことができます。大規模なデータや継続的に送られてくるデータを、メモリに全てロードすることなく段階的に処理できるため、リソースの効率的な利用にも貢献します。エンコーディングはコンストラクタで指定でき、対応しない文字が出現した場合の挙動も設定可能です。
構文(syntax)
1const decoderStream = new TextDecoderStream('utf-8');
引数(parameters)
encoding = 'utf-8', options = {}
- encoding: string = 'utf-8': デコードに使用するエンコーディングを指定します。デフォルトは 'utf-8' です。
- options: object = {}: デコーダーのオプションを指定するオブジェクトです。
戻り値(return)
戻り値なし
戻り値はありません