TextDecoder: TextDecoder() Konstruktor

Baseline Widely available

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der TextDecoder() Konstruktor gibt ein neu erstelltes TextDecoder-Objekt für die im Parameter angegebene Kodierung zurück.

Syntax

js
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, options)

Parameter

label Optional

Ein String, der 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 werfen muss, wenn ungültige Daten dekodiert werden. Der Standardwert ist false, was bedeutet, dass der Decoder fehlerhafte Daten mit einem Ersetzungszeichen 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 Dekodieren übersprungen und nicht im dekodierten Text enthalten 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

js
const textDecoder1 = new TextDecoder("iso-8859-2");
const textDecoder2 = new TextDecoder();
const textDecoder3 = new TextDecoder("csiso2022kr", { fatal: true }); // Allows TypeError exception to be thrown.
const textDecoder4 = new TextDecoder("iso-2022-cn"); // Throw a RangeError exception.

Spezifikationen

Specification
Encoding Standard
# ref-for-dom-textdecoder①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch