TextDecoder: encoding property
The TextDecoder.encoding
read-only property returns a string containing the name of the decoding algorithm used by the specific decoder object.
The encoding is set by the constructor label
parameter, and defaults to utf-8
.
Value
A lower-cased ASCII string, which can be one of the following values:
- The recommended encoding for the Web:
'utf-8'
. - The legacy single-byte encodings: 'ibm866', 'iso-8859-2', 'iso-8859-3', 'iso-8859-4', 'iso-8859-5', 'iso-8859-6', 'iso-8859-7', 'iso-8859-8''`, 'iso-8859-8i', 'iso-8859-10', 'iso-8859-13', 'iso-8859-14', 'iso-8859-15', 'iso-8859-16', 'koi8-r', 'koi8-u', 'macintosh', 'windows-874', 'windows-1250', 'windows-1251', 'windows-1252', 'windows-1253', 'windows-1254', 'windows-1255', 'windows-1256', 'windows-1257', 'windows-1258', or 'x-mac-cyrillic'.
- The legacy multi-byte Chinese (simplified) encodings: 'gbk', 'gb18030'.
- The legacy multi-byte Chinese (traditional) encoding: 'big5'.
- The legacy multi-byte Japanese encodings: 'euc-jp', 'iso-2022-jp', 'shift-jis'.
- The legacy multi-byte Korean encodings: 'euc-kr'.
-
The legacy miscellaneous encodings:
'utf-16be',
'utf-16le',
'x-user-defined'
. -
A special encoding,
'replacement'
. This decodes empty input into empty output and any other arbitrary-length input into a single replacement character. It is used to prevent attacks that mismatch encodings between the client and server. The following encodings also map to the replacement encoding:ISO-2022-CN
,ISO-2022-CN-ext
, 'iso-2022-kr', and 'hz-gb-2312'.
Specifications
Specification |
---|
Encoding Standard # ref-for-dom-textdecoder-encoding① |
Browser compatibility
BCD tables only load in the browser
See also
- The
TextDecoder
interface it belongs to.