CKTIS / JavaScript
TextEncoder — codificare il testo in UTF-8
TextEncoder converte il testo in byte UTF-8. Scopri la differenza tra encode() e encodeInto() e il significato dei contatori read e written.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder è un’API dell’Encoding Standard, non fa parte di ECMAScript. Supporta solo UTF-8: il costruttore non accetta etichette di codifica e encoding restituisce "utf-8".
encode(input) crea un nuovo Uint8Array; omettere input significa usare un testo vuoto. encodeInto(source, destination) scrive in un Uint8Array esistente. Restituisce read in unità di codice UTF-16 e written in byte. Se lo spazio non basta, non scrive una sequenza UTF-8 parziale.
Nell’esempio, il buffer può contenere Aą, ma non l’emoji. Verifica la disponibilità dell’API nel browser di destinazione; l’ambiente del repository non dimostra che il browser la supporti.
Esempi
const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));
const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));Risultato
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.