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.byteLengthnew 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