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. optionsOptional-
An object with the property:
fatal-
A boolean value indicating if this object must throw a
TypeErrorwhen 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
labelis 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