TextDecoderStream: TextDecoderStream() Konstruktor
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Der TextDecoderStream()
Konstruktor erstellt ein neues TextDecoderStream
Objekt, das verwendet wird, um einen Textstrom in einer binären Kodierung in Zeichenfolgen zu konvertieren.
Syntax
new TextDecoderStream(label)
new TextDecoderStream(label, options)
Parameter
label
-
Eine Zeichenfolge, die standardmäßig auf
utf-8
gesetzt ist. Dies kann jedes gültige Label sein. options
Optional-
Ein Objekt mit den folgenden Eigenschaften:
fatal
Optional-
Ein boolescher Wert, der angibt, ob die Methode
TextDecoder.decode()
eineTypeError
auslösen muss, wenn ungültige Daten decodiert werden. Der Standardwert istfalse
, was bedeutet, dass der Decoder fehlerhafte Daten durch ein Ersatzzeichen ersetzt. ignoreBOM
Optional-
Ein boolescher Wert, der angibt, ob das Byte Order Mark in die Ausgabe aufgenommen oder übersprungen wird. Der Standardwert ist
false
, was bedeutet, dass das Byte Order Mark beim Decodieren übersprungen wird und nicht in den decodierten Text aufgenommen wird.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn der Wert von
label
unbekannt ist oder einer der Werte ist, die zu einem'replacement'
Dekodierungsalgorithmus führen ("iso-2022-cn"
oder"iso-2022-cn-ext"
).
Beispiele
Das folgende Beispiel zeigt, wie binäre Daten dekodiert werden, die durch einen fetch()
Aufruf abgerufen werden.
Die Daten werden als UTF-8 interpretiert, da kein label
angegeben wurde.
const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());
Spezifikationen
Specification |
---|
Encoding Standard # ref-for-dom-textdecoderstream① |
Browser-Kompatibilität
BCD tables only load in the browser