The TextDecoder.decode() method returns a string containing text decoded from the buffer passed as a parameter.
The decoding method is defined in the current TextDecoder object. This includes the expected encoding of the data, and how decoding errors are handled.
js
decode()
decode(buffer)
decode(buffer, options)
buffer Optional
An ArrayBuffer, a TypedArray, or a DataView object containing the encoded text to decode.
options Optional
An object with the property:
stream
A boolean flag indicating whether additional data will follow in subsequent calls to decode(). Set to true if processing the data in chunks, and false for the final chunk or if the data is not chunked. It defaults to false.
TypeError
Thrown if there is a decoding error when the property TextDecoder.fatal is true.
A string.
This example encodes and decodes the euro symbol, €.
html
<p>Encoded value: <span id="encoded-value"></span></p>
<p>Decoded value: <span id="decoded-value"></span></p>
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;
| Specification |
|---|
| Encoding Standard # ref-for-dom-textdecoder-decode① |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
decode |
38 | 79 | 19
18Implemented a slightly different version of the spec. |
No | 25 | 10.1 | 38 | 38 | 19
18Implemented a slightly different version of the spec. |
25 | 10.3 | 3.0 |
TextDecoder interface it belongs to.© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder/decode