Widely available すべての主要ブラウザで対応済み。安心して使用可能。

Text encoding and decoding

TextDecoder インターフェイスは、特定のテキストエンコーディング、例えば UTF-8、ISO-8859-2、KOI8-R、GBK などのデコーダーを表します。デコーダーは入力としてバイトストリームを受け取り、コードポイントのストリームを出力します。

ユーティリティ

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
TextDecoder
38
79
19
10.1
38
10.3
decode

TextDecoder.decode() メソッドは、引数として渡されたバッファーからデコードしたテキストを含む文字列を返します。
38
79
19
10.1
38
10.3
encoding

TextDecoder.encoding は読み取り専用のプロパティで、特定のデコーダオブジェクトが使用するデコードアルゴリズムの名前が入った文字列を返します。
38
79
19
10.1
38
10.3
fatal

fatal は TextDecoder インターフェイスの読み取り専用プロパティで、エラーモードが fatal であるかどうかを論理値で示します。
38
79
36
10.1
38
10.3
ignoreBOM

ignoreBOM は TextDecoder インターフェイスの読み取り専用プロパティで、バイトオーダーマークが無視されるかどうかを示す論理値です。
38
79
63
10.1
38
10.3
TextDecoder

TextDecoder() コンストラクターは、引数で指定されたエンコーディング用に新しく作成された TextDecoder オブジェクトを返します。
38
79
19
10.1
38
10.3
worker_support

労働者で利用可能
38
79
20
10.1
38
10.3
TextDecoderStream

TextDecoderStream はEncoding API のインターフェイスで、UTF-8 などのバイナリーエンコーディングのテキストストリームを文字列ストリームに変換します。 これは TextDecoder と同等のストリームです。
71
79
105
14.1
71
14.5
encoding

encoding は TextDecoderStream インターフェイスの読み取り専用プロパティで、このデコーダーが使用するエンコーディングアルゴリズムの名前が入った文字列を返します。
71
79
105
14.1
71
14.5
fatal

fatal は TextDecoderStream インターフェイスの読み取り専用プロパティで、TextDecoderStream オブジェクトのエラーモードが fatal に設定されているかどうかを論理値で示します。
71
79
105
14.1
71
14.5
ignoreBOM

ignoreBOM は TextDecoderStream インターフェイスの読み取り専用プロパティで、バイトオーダーマーク (BOM) が無視されるかどうかを示す論理値を返します。
71
79
105
14.1
71
14.5
readable

readable は TextDecoderStream インターフェイスの読み取り専用プロパティで、ReadableStream を返します。
71
79
105
14.1
71
14.5
TextDecoderStream

TextDecoderStream() コンストラクターは、新しい TextDecoderStream オブジェクトを生成します。これは、あるバイナリーエンコーディングのテキストのストリームを文字列に変換するために使用します。
71
79
105
14.1
71
14.5
writable

writable は TextDecoderStream インターフェイスの読み取り専用プロパティで、WritableStream を返します。
71
79
105
14.1
71
14.5
TextEncoder

TextEncoder はコードポイントのストリームを入力として受け取り、 UTF-8 のバイトストリームを出力します。
38
79
18
10.1
38
10.3
encode

TextEncoder.encode() メソッドは入力として文字列を取り、 Uint8Array に引数で与えられたテキストが TextEncoder オブジェクトで指定された方法でエンコードされたものが入ったものを返します。
38
79
18
10.1
38
10.3
encodeInto

TextEncoder.encodeInto() メソッドは、エンコードする文字列と、 UTF-8 エンコード後のテキスト格納先となる Uint8Array を受け取り、エンコードの進行状況を示す辞書オブジェクトを返します。 これは古い encode() メソッドよりも潜在的に性能が高く、特にターゲットバッファーが WASM ヒープへのビューである場合、より効果的です。
74
79
66
14.1
74
14.5
encoding

TextEncoder.encoding は読み取り専用プロパティで、特定のエンコーダーで使用されるエンコーディングアルゴリズムの名前が入った文字列を返します。
38
79
18
10.1
38
10.3
TextEncoder

TextEncoder() コンストラクターは、新しく生成された TextEncoder オブジェクトを返します。これは UTF-8 エンコーディングのバイトストリームを生成します。
38
79
18
10.1
38
10.3
worker_support

労働者で利用可能
38
79
20
10.1
38
10.3
TextEncoderStream

TextEncoderStream はEncoding API のインターフェイスで、文字列のストリームを UTF-8 エンコーディングのバイト列に変換します。これは TextEncoder と同等のストリームです。
71
79
105
14.1
71
14.5
encoding

encoding は TextEncoderStream インターフェイスの読み取り専用プロパティで、現在の TextEncoderStream オブジェクトが使用するエンコーディングアルゴリズムの名前が入った文字列を返します。
71
79
105
14.1
71
14.5
readable

readable は TextEncoderStream インターフェイスの読み取り専用プロパティで、ReadableStream を返します。
71
79
105
14.1
71
14.5
TextEncoderStream

TextEncoderStream() コンストラクター、文字列のストリームを UTF-8 エンコーディングを使用してバイト列に変換するために使用する、新しい TextEncoderStream オブジェクトを作成します。
71
79
105
14.1
71
14.5
writable

writable は TextEncoderStream インターフェイスの読み取り専用プロパティで、WritableStream を返します。
71
79
105
14.1
71
14.5
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (19)
実装メモ
  • 仕様書の内容を若干変更して実装しました。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (19)
実装メモ
  • 仕様書の内容を若干変更して実装しました。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (19)
実装メモ
  • 仕様書の内容を若干変更して実装しました。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (19)
実装メモ
  • 仕様書の内容を若干変更して実装しました。

実務での使いどころ

  • Text encoding and decoding の活用

    TextDecoder インターフェイスは、特定のテキストエンコーディング、例えば UTF-8、ISO-8859-2、KOI8-R、GBK などのデコーダーを表します。

注意点

  • 古いブラウザでは対応していない場合がある。

実装メモ

  • 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。

参考リンク