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

TextDecoderメソッドは、Node.js環境において、与えられたバイト列を特定の文字エンコーディングに基づいて文字列に変換する処理を実行するメソッドです。この機能は、コンピュータが扱うバイナリデータを、人間が理解できるテキスト形式に変換する際に利用されます。特に、ファイルから読み込んだデータや、ネットワーク経由で受信したバイナリデータを、アプリケーション内で利用可能なJavaScriptの文字列として扱うために不可欠です。

例えば、UTF-8、UTF-16、Shift_JISなどの様々な文字エンコーディングに対応しており、入力バイト列がどのような文字コードでエンコードされているかを指定することで、正確な文字列へのデコードを実現します。これにより、多言語対応のシステム開発において、文字化けを防ぎ、データの整合性を保つ上で重要な役割を果たします。

このメソッドは、デコード対象となるバイト列（BufferやTypedArrayなど）を受け取り、それを指定された文字セットのルールに従って解析し、結果としてJavaScriptの文字列を返します。また、エラー処理に関するオプションも提供されており、不正なバイトシーケンスが検出された際にも、処理を継続するか、エラーを発生させるかといった挙動を細かく制御できるため、堅牢なデータ処理が可能です。データの読み込み、解析、表示、通信といった幅広いシナリオで活用されます。

Copy
1const encodedBytes = new Uint8Array([72, 101, 108, 108, 111]); // UTF-8 "Hello"
2const decoder = new TextDecoder('utf-8');
3const decodedString = decoder.decode(encodedBytes);
4console.log(decodedString);

label = 'utf-8', options = {}

• label: string = 'utf-8': デコードに使用するエンコーディングを指定します。デフォルトは 'utf-8' です。
• options: object = {}: デコーダーの追加オプションを指定するオブジェクトです。

TextDecoder

TextDecoderメソッドは、指定されたエンコーディング（UTF-8がデフォルト）を使用して、Bufferなどのバイト列を文字列にデコードした結果である新しいTextDecoderインスタンスを返します。