TextDecoderStream: TextDecoderStream() コンストラクター

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

構文

js
new TextDecoderStream(label)
new TextDecoderStream(label, options)

引数

label

文字列で、既定値は utf-8 です。 何れかの有効なラベルにすることができます。

options 省略可

次のプロパティを持つオブジェクトです。

fatal

論理値で、このオブジェクトが無効なデータをデコードした場合に TypeError を発生させる必要があるかどうかを示します。 既定値では false であり、これはデコードする際に不正なデータを置換文字で置き換えることを意味します。

例外

RangeError

label の値が未知の場合、または 'replacement' デコードアルゴリズム("iso-2022-cn" または "iso-2022-cn-ext")につながる値のいずれかである場合に発生します。

次の例は、fetch() の呼び出しから取得したバイナリーデータをデコードする方法を示しています。 このデータには label が渡されていないので、UTF-8 として解釈されます。

js
const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());

仕様書

Specification
Encoding Standard
# ref-for-dom-textdecoderstream①

ブラウザーの互換性

BCD tables only load in the browser