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

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年9月以降、すべてのブラウザーで利用可能です。

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

構文

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

label

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

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

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

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());

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

このページは役に立ちましたか？

はいいいえ

このページは MDN の貢献者によって 2025年6月24日に最終更新されました。