TextDecoderStream: TextDecoderStream() constructor
The TextDecoderStream()
constructor creates a new TextDecoderStream
object which is used to convert a stream of text in a binary encoding into strings.
Syntax
js
new TextDecoderStream(label)
new TextDecoderStream(label, options)
Parameters
label
-
A string defaulting to
utf-8
. This may be any valid label. options
Optional-
An object with the property:
fatal
-
A boolean value indicating if this object must throw a
TypeError
when decoding invalid data. It defaults tofalse
, which means that the decoder will substitute malformed data with a replacement character.
Exceptions
RangeError
-
Thrown if the value of
label
is unknown, or is one of the values leading to a'replacement'
decoding algorithm ("iso-2022-cn"
or"iso-2022-cn-ext"
).
Examples
The following example demonstrates how to decode binary data retrieved from a fetch()
call.
The data will be interpreted as UTF-8, as no label
has been passed.
js
const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());
Specifications
Specification |
---|
Encoding Standard # ref-for-dom-textdecoderstream① |
Browser compatibility
BCD tables only load in the browser