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: Diese Funktion ist in Web Workers verfügbar.

Der TextDecoder() Konstruktor gibt ein neues TextDecoder-Objekt zurück.

Syntax

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

Parameter

label Optional

Ein String, der die Zeichenkodierung identifiziert, die dieser Decoder verwenden wird. Dies kann jedes gültige Label sein.

Standardmäßig "utf-8".

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. Standardmäßig 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 einbezogen oder übersprungen wird. Standardmäßig false, was bedeutet, dass das byte order mark beim Dekodieren übersprungen 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

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");
// Throws a RangeError exception.

Spezifikationen

Specification
Encoding
# ref-for-dom-textdecoder①

Browser-Kompatibilität

Siehe auch