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
decode()
decode(buffer)
decode(buffer, options)
Parameter
buffer
Optional-
Ein
ArrayBuffer
, einTypedArray
oder einDataView
-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 auftrue
, wenn die Daten in Teilen verarbeitet werden, und auffalse
für das letzte Stück oder wenn die Daten nicht in Teilen vorliegen. Der Standardwert istfalse
.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn ein Dekodierungsfehler auftritt und die Eigenschaft
TextDecoder.fatal
auftrue
gesetzt ist.
Rückgabewert
Eine Zeichenkette.
Beispiele
Dieses Beispiel kodiert und dekodiert das Eurosymbol, €.
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 Standard # ref-for-dom-textdecoder-decode① |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das
TextDecoder
-Interface, zu dem es gehört.