TextEncoder()

TextEncoder() コンストラクターは、新しく生成された utf-8 の TextEncoder オブジェクトを返します。

構文

encoder = new TextEncoder(); 

引数

  • TextEncoder() は Firefox 48 以降および Chrome 53 以降では引数を取りません。

メモ: Firefox 48 以前や Chrome 53 以前は、 TextEncoder オブジェクトの引数としてエンコード型のラベルを受け付けていましたが、どちらのブラウザーも仕様書に合わせて utf-8 以外のエンコード型への対応を削除しました。 TextEncoder コンストラクターにどの型のラベルを渡しても無視され、 utf-8TextEncoder が生成されるようになりました。

例外

  • TextEncoder() は Firefox 48 以降および Chrome 53 以降では例外を発生させません。

メモ: Firefox 48 以前および Chrome 53 以前では、不明なエンコード型の場合に例外が発生していました。

仕様書

仕様書 状態 備考
Encoding
TextEncoder() の定義
現行の標準 初回定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
TextEncoder() constructor
実験的
Chrome 完全対応 53
補足
完全対応 53
補足
補足 Does not accept parameters. Supports only utf-8 encoding.
未対応 38 — 53
補足
補足 Throws RangeError exception for unknown encoding types.
Edge 未対応 なしFirefox 完全対応 48
補足
完全対応 48
補足
補足 The constructor accepts an encoding type label argument, but the value is ignored. Only utf-8 encoding is supported.
未対応 38 — 48
補足
補足 If the encoding type label argument is invalid, then a RangeError exception is thrown.
未対応 19 — 38
補足
補足 If the encoding type label argument is invalid, then a TypeError exception is thrown.
完全対応 18
補足
補足 Firefox 18 implemented an earlier and slightly different version of the specification.
IE 未対応 なしOpera 完全対応 25Safari 完全対応 10.1WebView Android 完全対応 38Chrome Android 完全対応 38Firefox Android 完全対応 48
補足
完全対応 48
補足
補足 The constructor accepts an encoding type label argument, but the value is ignored. Only utf-8 encoding is supported.
未対応 38 — 48
補足
補足 If the encoding type label argument is invalid, then a RangeError exception is thrown.
未対応 19 — 38
補足
補足 If the encoding type label argument is invalid, then a TypeError exception is thrown.
完全対応 18
補足
補足 Firefox 18 implemented an earlier and slightly different version of the specification.
Opera Android ? Safari iOS 完全対応 10.3Samsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。

関連情報