Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TextEncoder.encode i TypedArray.byteLength: brojanje bajtova UTF-8

Kodirajte tekst u UTF-8 i izmjerite broj dobivenih bajtova. Razlikujte ga od broja kodnih jedinica UTF-16, broja elemenata tipiziranog polja i veličine cijelog međuspremnika.

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

Sintaksa

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) poziva metodu instance koja kodira znakovni niz isključivo u UTF-8 i vraća novi Uint8Array. Bez argumenta vraća prazan Uint8Array. Svaku nesparenu surogatnu kodnu jedinicu zamjenjuje znakom U+FFFD umjesto da prijavi pogrešku.

view.byteLength je svojstvo samo za čitanje, a ne metoda. Daje broj bajtova u pogledu, dok view.length broji elemente, a view.buffer.byteLength broji bajtove cijelog međuspremnika. Ako je pogled unutar granica međuspremnika, view.byteLength iznosi view.length * view.BYTES_PER_ELEMENT. U Uint8Array svaki element zauzima jedan bajt. text.length broji kodne jedinice UTF-16, a ne bajtove UTF-8. Za provjeru ograničenja izraženog u bajtovima UTF-8 upotrijebite bytes.byteLength.

ECMAScript 2024 definira ovo svojstvo tipiziranih polja. TextEncoder je API web-platforme, a njegova dostupnost ovisi o okruženju izvođenja. Ako se veličina međuspremnika može mijenjati, može se promijeniti i veličina pogleda koji je prati. Čitanje byteLength vraća 0 ako je međuspremnik odvojen ili je pogled izvan njegovih granica. Poziv gettera na objektu koji nije tipizirano polje izaziva TypeError.

Primjeri

{
  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}`);
}

Rezultat

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é🙂` zauzima 4 kodne jedinice UTF-16 i 7 bajtova UTF-8. Pogled `Uint16Array` ima 3 elementa od po 2 bajta, pa obuhvaća 6 od 12 bajtova međuspremnika.

Povezane lekcije

  • JavaScript · Lekcija 17 · Napredno · Verzija: 4

Izvori