This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The TextDecoder.encoding read-only property returns a DOMString containing the name of the decoding algorithm used by the specific decoder.
It 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', and'hz-gb-2312'. - The legacy multi-byte Chinese (traditional) encoding:
'big5'. - The legacy multi-byte Japanese encodings:
'euc-jp','iso-2022-jp', and'shift-jis'. - The legacy multi-byte Korean encodings:
'euc-kr', and'iso-2022-kr'. - The legacy miscelleanous encodings:
'utf-16be','utf-16le', and'x-user-defined'. - A special encoding,
'replacement', which only emits an error and anEOFcode point. It is used to prevent attacks that mismatch encodings between the client and server. It can happen withISO-2022-CNandISO-2022-CN-ext.
Syntax
b = decoder.decoding;
Specifications
| Specification | Status | Comment |
|---|---|---|
| Encoding The definition of 'TextDecoder.encoding' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 38.0 | 19.0 (19.0) [1] | Not supported | 25 | Not supported |
| Available in Web Workers | 38.0 | 20.0 (20.0) | Not supported | 25 | Not supported |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| Basic support | Not supported | 38.0 | 19.0 (19.0) [1] | 1.0.1 (19.0) | Not supported | ? | Not supported | 38.0 |
| Available in Web Workers | Not supported | 38.0 | 20.0 (20.0) | 1.0.1 (20.0) | Not supported | ? | Not supported | 38.0 |
[1] An earlier, and slightly different, version of the specification was implemented in Firefox 18.
See also
- The
TextDecoderinterface it belongs to.