CKTIS / JavaScript
TextEncoder.encode a TypedArray.byteLength: počítání bajtů UTF-8
Zakódujte text do UTF-8 a zjistěte počet bajtů výsledku. Odlište jej od počtu kódových jednotek UTF-16, počtu prvků typovaného pole a velikosti celé vyrovnávací paměti.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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) volá metodu instance, která kóduje řetězec výhradně do UTF-8 a vrací nové pole Uint8Array. Bez argumentu vrací prázdné pole Uint8Array. Každou nespárovanou náhradní kódovou jednotku nahradí znakem U+FFFD, místo aby vyvolala chybu.
view.byteLength je vlastnost jen pro čtení, nikoli metoda. Udává počet bajtů v pohledu, zatímco view.length počítá prvky a view.buffer.byteLength udává počet bajtů celého podkladového bufferu. Je-li pohled v mezích bufferu, view.byteLength se rovná view.length * view.BYTES_PER_ELEMENT. V Uint8Array zabírá každý prvek jeden bajt. text.length počítá kódové jednotky UTF-16, nikoli bajty UTF-8. Pro kontrolu limitu v bajtech UTF-8 použijte bytes.byteLength.
ECMAScript 2024 definuje tuto vlastnost typovaných polí. TextEncoder je API webové platformy a jeho dostupnost závisí na běhovém prostředí. U bufferu s měnitelnou velikostí se může měnit velikost pohledu, který ji sleduje. Čtení byteLength vrátí 0, jestliže je buffer odpojený nebo pohled přesahuje jeho hranice. Volání getteru na objektu, který není typovaným polem, vyvolá TypeError.
Pří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ýsledek
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é🙂` zabírá 4 kódové jednotky UTF-16 a 7 bajtů UTF-8. Pohled `Uint16Array` obsahuje 3 prvky po 2 bajtech, takže zabírá 6 z 12 bajtů bufferu.
Související lekce
- JavaScript · Lekce 17 · Pokročilá · Verze: 4