This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextEncoder()
constructor returns a newly created utf-8 TextEncoder
object.
Syntax
encoder = new TextEncoder();
Parameters
- TextEncoder() takes no parameters since Firefox 48 and Chrome 53
Note: Prior to Firefox 48 and Chrome 53, an encoding type label was accepted as a paramer to the TextEncoder object, since then both browers have removed support for any encoder type other than utf-8, to match the spec. Any type label passed into the TextEncoder constructor will now be ignored and a utf-8 TextEncoder will be created.
Exceptions
- TextEncoder() throws no exceptions since Firefox 48 and Chrome 53
Note: Prior to Firefox 48 and Chrome 53 an exception would be thrown for an unknown encoding type.
Specifications
Specification | Status | Comment |
---|---|---|
Encoding The definition of 'TextEncoder()' in that specification. |
Living Standard | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 38 | 19.0 (19.0)[1] (utf-16 is not supported) |
No support | 25 | No support |
Available in Web Workers | 38 | 20.0 (20.0)[1] | No support | 25 | No support |
Feature | Android | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | 19.0 (19.0)[1] | 1.0.1 (19.0)[1] | No support | No support | No support |
Available in Web Workers | No support | 20.0 (20.0)[1] | 1.0.1 (20.0)[1] | No support | No support | No support |
[1] An earlier, and slightly different, version of the specification was implemented in Gecko 18.
Before Gecko 38, an invalid parameter lead to a TypeError
exception instead of the standard RangeError
.
See also
- The
TextEncoder
interface it belongs to.