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
new TextDecoderStream(label)
new TextDecoderStream(label, options)
Parameter
label-
Eine Zeichenfolge, die standardmäßig auf
utf-8gesetzt ist. Dies kann jedes gültige Label sein. optionsOptional-
Ein Objekt mit den folgenden Eigenschaften:
fatalOptional-
Ein boolescher Wert, der angibt, ob die Methode
TextDecoder.decode()einenTypeErrorauslösen muss, wenn ungültige Daten dekodiert werden. Standardmäßig ist er auffalsegesetzt, was bedeutet, dass der Decoder fehlerhafte Daten mit einem Ersatzzeichen ersetzt. ignoreBOMOptional-
Ein boolescher Wert, der angibt, ob das Byte-Order-Mark in die Ausgabe einbezogen oder übersprungen wird. Standardmäßig ist er auf
falsegesetzt, 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
labelunbekannt 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.
const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());
Spezifikationen
| Specification |
|---|
| Encoding # ref-for-dom-textdecoderstream① |