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

TextDecoderメソッドは、特定の文字エンコーディングで符号化されたバイトデータをJavaScriptの文字列にデコードする機能を提供するメソッドです。このメソッドは、厳密にはTextDecoderクラスのコンストラクタとして動作し、新しいTextDecoderオブジェクトのインスタンスを生成するために使用されます。生成されたTextDecoderインスタンスは、そのdecode()メソッドを使って、Uint8ArrayやArrayBufferといったバイナリデータを指定されたエンコーディングに基づいて、読みやすいテキスト形式に変換します。例えば、ネットワーク経由で受け取ったデータやファイルから読み込んだバイト列が、Shift_JISやEUC-JPなどの特定のエンコーディングで構成されている場合、それを適切にJavaScriptの文字列に変換し、文字化けを防ぐ際に非常に有効です。Node.js環境では、このTextDecoderはグローバルオブジェクトとして直接利用可能であり、モジュールをインポートすることなく手軽に利用できます。

Copy
1const decoder = new TextDecoder('utf-8');
2const encodedBytes = Buffer.from([0x4e, 0x6f, 0x64, 0x65, 0x2e, 0x6a, 0x73]);
3const decodedString = decoder.decode(encodedBytes);
4console.log(decodedString);

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

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

TextDecoder

TextDecoder メソッドは、指定されたエンコーディングを使用して Uint8Array などのバイト列を文字列にデコードした結果を返します。