TextDecoder: decode() メソッド
TextDecoder.decode()
メソッドは、引数として渡されたバッファーからデコードしたテキストを含む文字列を返します。
デコードするメソッドは、現在の TextDecoder
オブジェクトで定義されます。
これには、データの予想されるエンコードや、デコードエラーの処理方法などが含まれます。
構文
js
decode()
decode(buffer)
decode(buffer, options)
引数
buffer
省略可-
デコードするエンコードされたテキストが入っている、
ArrayBuffer
、TypedArray
、DataView
の何れかのオブジェクトです。 options
省略可-
以下のプロパティを持つオブジェクトです。
stream
-
論理値のフラグで、以後
decode()
を呼び出す際に、追加データが続くかどうかを示します。 データを塊で処理する場合はtrue
に設定し、最後の塊、またはデータが塊でない場合はfalse
に設定します。 既定値はfalse
です。
例外
TypeError
-
TextDecoder.fatal
プロパティがtrue
の場合、デコードエラーがあると発生します。
返値
文字列です。
例
この例では、ユーロ記号 € をエンコードし、デコードしています。
HTML
html
<p>Encoded value: <span id="encoded-value"></span></p>
<p>Decoded value: <span id="decoded-value"></span></p>
JavaScript
js
const encoder = new TextEncoder();
const array = encoder.encode("€"); // Uint8Array(3) [226, 130, 172]
document.getElementById("encoded-value").textContent = array;
const decoder = new TextDecoder();
const str = decoder.decode(array); // String "€"
document.getElementById("decoded-value").textContent = str;
結果
仕様書
Specification |
---|
Encoding Standard # ref-for-dom-textdecoder-decode① |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- 所属先の
TextDecoder
インターフェイス。