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.