Encoding

TextEncoder кодирует строки в UTF-8. TextDecoder поддерживает UTF-8, UTF-16, устаревшие однобайтовые кодировки и распространённые кодировки CJK по меткам WHATWG.

const bytes = new TextEncoder().encode("Hello, мир! 🌍");
new TextDecoder().decode(bytes); // "Hello, мир! 🌍"

TextEncoder

Элемент	Результат
`encoding`	Всегда `"utf-8"`.
`encode(input = "")`	Новый `Uint8Array`.
`encodeInto(source, destination)`	`{ read, written }` без неполных кодовых точек.

Непарные суррогаты заменяются на U+FFFD.

TextDecoder

const decoder = new TextDecoder("latin1");
decoder.decode(new Uint8Array([0x80])); // "€"

Метки обрезаются и нормализуются по регистру. Псевдонимы, такие как ascii, iso-8859-1 и latin1, выбирают Windows-1252. Неизвестные метки и метка replacement приводят к RangeError.

Параметры:

fatal: true отклоняет некорректный ввод с TypeError;
ignoreBOM управляет обработкой начального BOM;
decode(input, { stream: true }) сохраняет неполную последовательность до следующего вызова.

const decoder = new TextDecoder();
decoder.decode(new Uint8Array([0xc3]), { stream: true }); // ""
decoder.decode(new Uint8Array([0xa9])); // "é"

Потоковая обработка

TextEncoderStream преобразует строковые фрагменты в байты UTF-8. TextDecoderStream преобразует фрагменты байтов в строки, сохраняя неполные многобайтовые последовательности между фрагментами.

Конструкторы нужно вызывать с new.

Reference

Status: Full · 14,178 of 14,266 suite tests pass (99.4%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`TextDecoder`	class	Full	`encoding`, `fatal`, `ignoreBOM`, `decode()`
`TextEncoder`	class	Full	`encoding`, `encode()`, `encodeInto()`

Tests: wpt-wintertc encoding: 14,178 pass, 86 fail, 2 error, 329 skipped. Failing: encoding/encodeInto.any.js (65), encoding/textdecoder-streaming.any.js (16), encoding/streams/decode-bad-chunks.any.js (2), encoding/idlharness.any.js, encoding/single-byte-decoder.window.js, encoding/streams/decode-utf8.any.js, encoding/streams/realms.window.js, encoding/textdecoder-copy.any.js.