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 Januar 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
decode()
decode(buffer)
decode(buffer, options)
Parameter
bufferOptional-
Ein
ArrayBuffer, einTypedArray, oder einDataView-Objekt, das den zu decodierenden kodierten Text enthält. optionsOptional-
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 auftrue, wenn die Daten in Teilen verarbeitet werden, und auffalsefür das letzte Teil oder wenn die Daten nicht in Teilen vorliegen. Der Standardwert istfalse.
Ausnahmen
TypeError-
Wird ausgelöst, wenn ein Dekodierungsfehler auftritt und die Eigenschaft
TextDecoder.fatalauftruegesetzt ist.
Rückgabewert
Ein String.
Beispiele
Dieses Beispiel kodiert und decodiert das Euro-Symbol, €.
HTML
<p>Encoded value: <span id="encoded-value"></span></p>
<p>Decoded value: <span id="decoded-value"></span></p>
JavaScript
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
Loading…
Siehe auch
- Das
TextDecoder-Interface, zu dem es gehört.