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

js
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() eine TypeError auslösen muss, wenn ungültige Daten decodiert werden. Der Standardwert ist false, 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.

js
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