CKTIS / JavaScript
TextEncoder.encode() — convertire il testo in byte UTF-8
TextEncoder.encode() codifica una stringa JavaScript come UTF-8 e restituisce un Uint8Array contenente i byte risultanti. Chiama il metodo su un’istanza di TextEncoder; il numero di byte non corrisponde necessariamente alla lunghezza della stringa.
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
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode è un metodo di istanza: crea un oggetto con new TextEncoder() e poi chiama encoder.encode(text). Il risultato è un Uint8Array che contiene i byte UTF-8 del testo, non una nuova stringa. TextEncoder supporta solo UTF-8; non serve a scegliere altre codifiche.
Non confondere text.length con la dimensione dei dati codificati. La lunghezza di una stringa JavaScript si misura in unità di codice UTF-16, mentre bytes.length conta i byte risultanti. Nell’esempio, A occupa un byte e € ne occupa tre: la stringa "A€" ha lunghezza 2, ma il risultato codificato contiene 4 byte.
encode() crea l’array risultato. Se vuoi scrivere in un Uint8Array esistente, puoi valutare il metodo distinto encodeInto(): accetta un array di destinazione e restituisce informazioni sull’avanzamento invece di un array di byte. Verifica il suo supporto indipendentemente da quello di encode().
Questa è una Web API definita dallo standard Encoding, non una funzionalità associata a un’edizione di ECMAScript. Secondo MDN, encode() è ampiamente disponibile nei browser da gennaio 2020 e funziona anche nei Web Workers. La sua presenza in Node 24 non dimostra che sia supportata nel browser di destinazione.
Esempi
const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);Risultato
true 65,226,130,172 2 4
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.