CKTIS / JavaScript
TextEncoder.encode i TypedArray.byteLength: długość w bajtach UTF-8
Zakoduj tekst do UTF-8, a następnie odczytaj liczbę bajtów wyniku. Odróżnij ją od liczby jednostek kodowych UTF-16, liczby elementów tablicy typowanej i rozmiaru całego bufora.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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) to wywołanie metody instancji. Koduje łańcuch znaków wyłącznie w UTF-8 i zwraca nową tablicę Uint8Array. Bez argumentu zwraca pustą tablicę Uint8Array. Każda niesparowana jednostka surogatowa jest zastępowana przez U+FFFD, a nie odrzucana jako błąd.
view.byteLength to właściwość tylko do odczytu, nie metoda. Podaje liczbę bajtów widoku, podczas gdy view.length liczy elementy, a view.buffer.byteLength podaje rozmiar całego bufora w bajtach. W widoku mieszczącym się w granicach bufora view.byteLength wynosi view.length * view.BYTES_PER_ELEMENT. W Uint8Array każdy element zajmuje jeden bajt. text.length liczy jednostki kodowe UTF-16, a nie bajty UTF-8. Gdy limit dotyczy bajtów UTF-8, sprawdzaj bytes.byteLength.
ECMAScript 2024 definiuje właściwość tablic typowanych. TextEncoder należy do platformy webowej i jego dostępność zależy od środowiska uruchomieniowego. W przypadku bufora o zmiennym rozmiarze długość widoku, który dostosowuje się do rozmiaru bufora, może się zmienić. Odczyt byteLength daje 0, gdy bufor jest odłączony lub widok wykracza poza jego granice. Wywołanie gettera na obiekcie, który nie jest tablicą typowaną, zgłasza TypeError.
Przykłady
{
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}`);
}Wynik
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é🙂` zajmuje 4 jednostki kodowe UTF-16 i 7 bajtów UTF-8. Widok `Uint16Array` ma 3 elementy po 2 bajty, więc obejmuje 6 z 12 bajtów bufora.
Powiązane lekcje
- JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4