TextDecoderStream: TextDecoderStream()-Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2022.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Der TextDecoderStream()-Konstruktor erstellt ein neues TextDecoderStream-Objekt, das verwendet wird, um einen Strom von Text in einer binären Codierung in Zeichenfolgen umzuwandeln.

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() einen TypeError auslösen muss, wenn ungültige Daten dekodiert werden. Standardmäßig ist er auf false gesetzt, was bedeutet, dass der Decoder fehlerhafte Daten mit einem Ersatzzeichen ersetzt.

ignoreBOM Optional

Ein boolescher Wert, der angibt, ob das Byte-Order-Mark in die Ausgabe einbezogen oder übersprungen wird. Standardmäßig ist er auf false gesetzt, was bedeutet, dass das Byte-Order-Mark beim Dekodieren übersprungen wird und nicht in den dekodierten Text einbezogen 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, die von einem fetch()-Aufruf abgerufen wurden, dekodiert werden. Die Daten werden als UTF-8 interpretiert, da kein label übergeben wurde.

js
const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());

Spezifikationen

Specification
Encoding
# ref-for-dom-textdecoderstream①

Browser-Kompatibilität