TextDecoderStream: TextDecoderStream() コンストラクター
TextDecoderStream()
コンストラクターは、新しい TextDecoderStream
オブジェクトを生成します。これは、あるバイナリーエンコーディングのテキストのストリームを文字列に変換するために使用します。
構文
js
new TextDecoderStream(label)
new TextDecoderStream(label, options)
引数
label
-
文字列で、既定値は
utf-8
です。 何れかの有効なラベルにすることができます。 options
省略可-
次のプロパティを持つオブジェクトです。
例外
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