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

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 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());

Specification

Enable JavaScript to view this browser compatibility table.

Was this page helpful to you?

Yes No

This page was last modified on 2025年6月24日 by MDN contributors.