Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TextEncoder.encode a TypedArray.byteLength: počítanie bajtov UTF-8

Zakódujte text do UTF-8 a zistite počet bajtov výsledku. Odlíšte ho od počtu kódových jednotiek UTF-16, počtu prvkov typovaného poľa a veľkosti celého podkladového buffera.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const encoder = new TextEncoder();
const bytes = encoder.encode(text);
const byteCount = bytes.byteLength;
// With no argument, encoder.encode() returns an empty Uint8Array.
// For any typed-array instance: view.byteLength

new TextEncoder().encode(text) volá metódu inštancie, ktorá kóduje reťazec výhradne do UTF-8 a vracia nové pole Uint8Array. Bez argumentu vráti prázdne pole Uint8Array. Každú nespárovanú náhradnú kódovú jednotku nahradí znakom U+FFFD namiesto vyvolania chyby.

view.byteLength je vlastnosť iba na čítanie, nie metóda. Udáva počet bajtov pohľadu, kým view.length počíta prvky a view.buffer.byteLength udáva počet bajtov celého podkladového buffera. Ak pohľad nepresahuje hranice buffera, view.byteLength sa rovná view.length * view.BYTES_PER_ELEMENT. V Uint8Array zaberá každý prvok jeden bajt. text.length počíta kódové jednotky UTF-16, nie bajty UTF-8. Pri kontrole limitu v bajtoch UTF-8 použite bytes.byteLength.

ECMAScript 2024 definuje túto vlastnosť typovaných polí. TextEncoder je API webovej platformy a jeho dostupnosť závisí od behového prostredia. Pri bufferi s meniteľnou veľkosťou sa môže meniť veľkosť pohľadu, ktorý sleduje jeho veľkosť. Čítanie byteLength vráti 0, ak je buffer odpojený alebo pohľad presahuje jeho hranice. Volanie gettera na objekte, ktorý nie je typovaným poľom, vyvolá TypeError.

Príklady

{
  const text = "Aé🙂";
  const bytes = new TextEncoder().encode(text);
  console.log(`text.length=${text.length}; bytes.length=${bytes.length}; bytes.byteLength=${bytes.byteLength}`);
  console.log(bytes.join(","));

  const view = new Uint16Array(new ArrayBuffer(12), 2, 3);
  console.log(`view.length=${view.length}; view.byteLength=${view.byteLength}; view.buffer.byteLength=${view.buffer.byteLength}`);
}

Výsledok

text.length=4; bytes.length=7; bytes.byteLength=7
65,195,169,240,159,153,130
view.length=3; view.byteLength=6; view.buffer.byteLength=12

`Aé🙂` zaberá 4 kódové jednotky UTF-16 a 7 bajtov UTF-8. Pohľad `Uint16Array` má 3 prvky po 2 bajtoch, takže zaberá 6 z 12 bajtov buffera.

Súvisiace lekcie

  • JavaScript · Lekcia 17 · Pokročilá · Verzia: 4

Zdroje