TextDecoder: decode() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.

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;