Baseline Widely available
Note: This feature is available in Web Workers.
The TextDecoder
interface represents a decoder for a specific text encoding, such as UTF-8
, ISO-8859-2
, or GBK
. A decoder takes an array of bytes as input and returns a JavaScript string.
TextDecoder()
Creates and returns a new TextDecoder
.
The TextDecoder
interface doesn't inherit any properties.
TextDecoder.encoding
Read only
A string containing the name of the character encoding system that this TextDecoder
will use.
TextDecoder.fatal
Read only
A boolean indicating whether the error mode is fatal.
TextDecoder.ignoreBOM
Read only
A boolean indicating whether the byte order mark is ignored.
The TextDecoder
interface doesn't inherit any methods.
TextDecoder.decode()
Decodes the given bytes into a JavaScript string and returns it.
This example shows how to decode the UTF-8 encoding of the character "ð ®·".
<button id="decode">Decode</button>
<button id="reset">Reset</button>
<div id="output"></div>
const utf8decoder = new TextDecoder(); // default 'utf-8'
const encodedText = new Uint8Array([240, 160, 174, 183]);
const output = document.querySelector("#output");
const decodeButton = document.querySelector("#decode");
decodeButton.addEventListener("click", () => {
output.textContent = utf8decoder.decode(encodedText);
});
const resetButton = document.querySelector("#reset");
resetButton.addEventListener("click", () => {
window.location.reload();
});
Decoding non-UTF8 text
In this example, we decode the Russian text "ÐÑивеÑ, миÑ!", which means "Hello, world." In our TextDecoder()
constructor, we specify the Windows-1251 character encoding.
<button id="decode">Decode</button>
<button id="reset">Reset</button>
<div id="decoded"></div>
const win1251decoder = new TextDecoder("windows-1251");
const encodedText = new Uint8Array([
207, 240, 232, 226, 229, 242, 44, 32, 236, 232, 240, 33,
]);
const decoded = document.querySelector("#decoded");
const decodeButton = document.querySelector("#decode");
decodeButton.addEventListener("click", () => {
decoded.textContent = win1251decoder.decode(encodedText);
});
const resetButton = document.querySelector("#reset");
resetButton.addEventListener("click", () => {
window.location.reload();
});
Specifications Browser compatibility See also
TextEncoder
interface describing the inverse operation.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4