База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

TextEncoder.encode и TypedArray.byteLength: броене на байтове в UTF-8

Кодирайте текст в UTF-8 и измерете броя на получените байтове. Разграничете го от броя кодови единици в UTF-16, броя елементи в типизиран масив и размера на целия буфер.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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) извиква метод на екземпляр, който кодира низ само в UTF-8 и връща нов Uint8Array. Без аргумент връща празен Uint8Array. Всяка несдвоена сурогатна кодова единица се заменя с U+FFFD, вместо да предизвика грешка.

view.byteLength е свойство само за четене, а не метод. То дава броя байтове в изгледа; view.length брои елементите, а view.buffer.byteLength брои байтовете в целия буфер. Когато изгледът е в границите на буфера, view.byteLength е равно на view.length * view.BYTES_PER_ELEMENT. В Uint8Array всеки елемент заема един байт. text.length брои кодови единици в UTF-16, а не байтове в UTF-8. Използвайте bytes.byteLength, за да проверите ограничение, зададено в байтове на UTF-8.

ECMAScript 2024 определя това свойство на типизираните масиви. TextEncoder е API на уеб платформата и наличността му зависи от средата за изпълнение. При буфер с променлив размер изглед, който следва размера на буфера, може да промени размера си. Четенето на byteLength връща 0, ако буферът е отделен или изгледът е извън границите му. Извикването на гетъра върху обект, който не е типизиран масив, предизвиква TypeError.

Примери

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

Резултат

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é🙂` заема 4 кодови единици в UTF-16 и 7 байта в UTF-8. Изгледът `Uint16Array` има 3 елемента по 2 байта и обхваща 6 от общо 12 байта в буфера.

Свързани уроци

  • JavaScript · Урок 17 · Напреднало · Версия: 4

Източници