TextDecoder: decode()-Methode

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.

Die Methode TextDecoder.decode() gibt einen String zurück, der aus dem übergebenen Puffer decodierten Text enthält.

Die Decodiermethode ist im aktuellen TextDecoder-Objekt definiert. Dies umfasst die erwartete Kodierung der Daten und wie Dekodierungsfehler behandelt werden.

Syntax

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

Parameter

buffer Optional

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

options Optional

Ein Objekt mit der Eigenschaft:

stream

Ein boolescher Wert, der anzeigt, ob zusätzliche Daten in nachfolgenden Aufrufen von decode() folgen werden. Setzen Sie ihn auf true, wenn die Daten in Teilen verarbeitet werden, und auf false für das letzte Teil 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

Ein String.

Beispiele

Dieses Beispiel kodiert und decodiert das Euro-Symbol, €.

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
# ref-for-dom-textdecoder-decode①

Browser-Kompatibilität

Siehe auch