Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti