Skip to main content
Select language
Skip to search

MDN Web Docs

Sign in

Encoding API

- No translations exist for this article.
- Add a translation
Edit
Advanced
- History
- Print this article

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The Encoding API provides a mechanism for handling text in various character encodings, including legacy non-UTF-8 encodings.

The API provides four interfaces: TextDecoder, TextEncoder, TextDecoderStream and TextEncoderStream.

Interfaces

Tutorials & tools

A shim allowing to use this interface in browsers that don't support it.
StringView – a C-like representation of strings based on typed arrays.

Specifications

Specification	Status	Comment
Encoding	Living Standard	Initial definition.

Browser compatibility

`TextDecoder`

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Basic support	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
Available in workers	Chrome Full support 38	Edge ?	Firefox Full support 20	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 20	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`TextDecoder()` constructor	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`decode`	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`encoding`	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Partial support 18 Notes Notes Implemented a slightly different version of the spec.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`fatal`	Chrome ?	Edge ?	Firefox ?	IE ?	Opera ?	Safari Full support 10.1	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android ?	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`ignoreBOM`	Chrome ?	Edge ?	Firefox ?	IE ?	Opera ?	Safari Full support 10.1	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android ?	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
See implementation notes.: See implementation notes.

`TextEncoder`

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Basic support Experimental	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
Available in Web Workers Experimental	Chrome Full support 38	Edge ?	Firefox Full support 20	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 20	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`TextEncoder()` constructor Experimental	Chrome Full support 53 Notes Full support 53 Notes Notes Does not accept parameters. Supports only `utf-8` encoding. No support 38 — 53 Notes Notes Throws `RangeError` exception for unknown encoding types.	Edge ?	Firefox Full support 48 Notes Full support 48 Notes Notes The constructor accepts an encoding type label argument, but the value is ignored. Only `utf-8` encoding is supported. No support 38 — 48 Notes Notes If the encoding type label argument is invalid, then a `RangeError` exception is thrown. No support 19 — 38 Notes Notes If the encoding type label argument is invalid, then a `TypeError` exception is thrown. Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 48 Notes Full support 48 Notes Notes The constructor accepts an encoding type label argument, but the value is ignored. Only `utf-8` encoding is supported. No support 38 — 48 Notes Notes If the encoding type label argument is invalid, then a `RangeError` exception is thrown. No support 19 — 38 Notes Notes If the encoding type label argument is invalid, then a `TypeError` exception is thrown. Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`encoding` Experimental	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?
`encode` Experimental	Chrome Full support 38	Edge ?	Firefox Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	IE No support No	Opera Full support 25	Safari Full support 10.1	WebView Android Full support 38	Chrome Android Full support 38	Edge Mobile ?	Firefox Android Full support 19 Full support 19 Full support 18 Notes Notes Firefox 18 implemented an earlier and slightly different version of the specification.	Opera Android ?	Safari iOS Full support 10.1	Samsung Internet Android ?

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.
See implementation notes.: See implementation notes.

Document Tags and Contributors

Tags:

Contributors to this page: mdnwebdocs-bot, SaschaNaz, ExE-Boss, fscholz, sideshowbarker, NIPE-SYSTEMS, teoli, jpmedley, kscarfone, realityking, fusionchess

Last updated by: mdnwebdocs-bot, Mar 18, 2019, 5:09:27 PM

Related Topics

Encoding API
Interfaces
1. TextDecoder
2. TextEncoder