Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TextEncoder — kódování textu do UTF-8

TextEncoder převádí text na bajty UTF-8. Zjistěte, jaký je rozdíl mezi encode() a encodeInto() a co znamenají počítadla read a written.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)

TextEncoder je API ze standardu Encoding Standard, nikoli součást samotného ECMAScriptu. Podporuje pouze UTF-8: konstruktor nepřijímá označení kódování a encoding vrací "utf-8".

encode(input) vytvoří nové Uint8Array; vynechání input znamená prázdný text. encodeInto(source, destination) zapisuje do existujícího Uint8Array. Vrací read v jednotkách kódu UTF-16 a written v bajtech. Pokud není dost místa, nezapíše neúplnou sekvenci UTF-8.

V příkladu se do bufferu vejde Aą, ale ne emoji. Dostupnost API ověřte v cílovém prohlížeči; prostředí repozitáře nedokládá, že ji prohlížeč podporuje.

Příklady

const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));

const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));

Výsledek

utf-8
65,196,133,240,159,152,128
2 3
65,196,133

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje