TextDecoder: Methode decode()

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.

Die TextDecoder.decode()-Methode gibt einen Zeichenfolgeninhalt zurück, der aus dem als Parameter übergebenen Puffer dekodiert wird.

Die Dekodierungsmethode ist im aktuellen TextDecoder-Objekt definiert. Dies umfasst die erwartete Kodierung der Daten und die Behandlung von Dekodierungsfehlern.

Syntax

js
decode()
decode(buffer)
decode(buffer, options)

Parameter

buffer Optional

Ein ArrayBuffer, ein TypedArray oder ein DataView-Objekt, das den zu dekodierenden Text enthält.

options Optional

Ein Objekt mit der Eigenschaft:

stream

Ein boolesches Flag, das angibt, ob zusätzliche Daten bei nachfolgenden Aufrufen von decode() folgen werden. Setzen Sie es auf true, wenn die Daten in Teilen verarbeitet werden, und auf false für das letzte Stück oder wenn die Daten nicht in Teilen vorliegen. Der Standardwert ist false.

Ausnahmen

TypeError

Wird ausgelöst, wenn ein Dekodierungsfehler auftritt und die Eigenschaft TextDecoder.fatal auf true gesetzt ist.

Rückgabewert

Eine Zeichenkette.

Beispiele

Dieses Beispiel kodiert und dekodiert das Eurosymbol, €.

HTML

html
<p>Encoded value: <span id="encoded-value"></span></p>
<p>Decoded value: <span id="decoded-value"></span></p>

JavaScript

js
const encoder = new TextEncoder();
const array = encoder.encode("€"); // Uint8Array(3) [226, 130, 172]
document.getElementById("encoded-value").textContent = array;

const decoder = new TextDecoder();
const str = decoder.decode(array); // String "€"
document.getElementById("decoded-value").textContent = str;

Ergebnis

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch