Baseline Widely available
Note: This feature is available in Web Workers.
The TextDecoder()
constructor returns a new TextDecoder
object.
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, options)
Parameters
label
Optional
A string identifying the character encoding that this decoder will use. This may be any valid label.
Defaults to "utf-8"
.
options
Optional
An object with the following properties:
fatal
Optional
A boolean value indicating if the TextDecoder.decode()
method must throw a TypeError
when decoding invalid data. It defaults to false
, which means that the decoder will substitute malformed data with a replacement character.
ignoreBOM
Optional
A boolean value indicating whether the byte order mark will be included in the output or skipped over. It defaults to false
, which means that the byte order mark will be skipped over when decoding and will not be included in the decoded text.
RangeError
Thrown if the value of label
is unknown, or is one of the values leading to a 'replacement'
decoding algorithm ("iso-2022-cn"
or "iso-2022-cn-ext"
).
const textDecoder1 = new TextDecoder("iso-8859-2");
const textDecoder2 = new TextDecoder();
const textDecoder3 = new TextDecoder("csiso2022kr", { fatal: true });
// Allows TypeError exception to be thrown.
const textDecoder4 = new TextDecoder("iso-2022-cn");
// Throws a RangeError exception.
Specifications Browser compatibility See also
TextDecoder
interface it belongs to.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