Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TextEncoder.encode e TypedArray.byteLength: contare i byte UTF-8

Codifica il testo in UTF-8 e misura i byte ottenuti. Distingui questa misura dal numero di unità di codice UTF-16, dal numero di elementi di un array tipizzato e dalla dimensione dell’intero buffer.

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

Sintassi

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) chiama un metodo di istanza che codifica una stringa solo in UTF-8 e restituisce un nuovo Uint8Array. Senza argomenti restituisce un Uint8Array vuoto. Ogni unità surrogata senza coppia viene sostituita con U+FFFD anziché causare un errore.

view.byteLength è una proprietà di sola lettura, non un metodo. Conta i byte della vista; view.length conta gli elementi e view.buffer.byteLength conta i byte dell’intero buffer sottostante. Se la vista rientra nei limiti del buffer, view.byteLength equivale a view.length * view.BYTES_PER_ELEMENT. In un Uint8Array ogni elemento occupa un byte. text.length conta le unità di codice UTF-16, non i byte UTF-8. Usa bytes.byteLength per controllare un limite espresso in byte UTF-8.

ECMAScript 2024 definisce la proprietà degli array tipizzati. TextEncoder è un’API della piattaforma web e la sua disponibilità dipende dall’ambiente di esecuzione. Con un buffer ridimensionabile, una vista che segue la dimensione del buffer può cambiare dimensione. La lettura di byteLength restituisce 0 se il buffer è scollegato o la vista è fuori dai suoi limiti. Invocare il getter su un oggetto che non è un array tipizzato genera un TypeError.

Esempi

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

Risultato

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é🙂` occupa 4 unità di codice UTF-16 e 7 byte UTF-8. La vista `Uint16Array` ha 3 elementi da 2 byte ciascuno, quindi copre 6 dei 12 byte del buffer.

Lezioni correlate

  • JavaScript · Lezione 17 · Avanzato · Versione: 4

Fonti