TextDecoder.decode()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextDecode.decode()
method returns a
string containing the text, given in parameters, decoded with the
specific method for that TextDecoder
> object.
Syntax
decode()
decode(buffer)
decode(buffer, options)
Parameters
buffer
Optional-
Is an
ArrayBuffer
, aTypedArray
or aDataView
object containing the text to decode. options
Optional-
An object with the property:
stream
-
A boolean flag indicating that 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.
Return value
A string.
Examples
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>
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;
Result
Specifications
Specification |
---|
Encoding # ref-for-dom-textdecoder-decode① |
Browser compatibility
BCD tables only load in the browser
See also
- The
TextDecoder
interface it belongs to.