CKTIS / JavaScript
TextEncoder.encode() — converter texto em bytes UTF-8
TextEncoder.encode() codifica uma cadeia de caracteres JavaScript como UTF-8 e devolve um Uint8Array com os bytes resultantes. Chame o método numa instância de TextEncoder; o número de bytes pode não corresponder ao comprimento da cadeia.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode é um método de instância: crie um objeto com new TextEncoder() e, em seguida, chame encoder.encode(text). O resultado é um Uint8Array com os bytes UTF-8 do texto, não uma nova cadeia de caracteres. TextEncoder suporta apenas UTF-8; não permite escolher outras codificações.
Não confunda text.length com o tamanho dos dados codificados. O comprimento de uma cadeia de caracteres JavaScript é medido em unidades de código UTF-16, enquanto bytes.length conta os bytes resultantes. No exemplo, A ocupa um byte e € ocupa três: a cadeia "A€" tem comprimento 2, mas o resultado codificado contém 4 bytes.
encode() cria o array de resultado. Se quiser escrever num Uint8Array existente, considere o método separado encodeInto(): aceita um array de destino e devolve informações sobre o progresso, em vez de um array de bytes. Verifique o respetivo suporte independentemente do suporte de encode().
Esta é uma API Web definida pela norma Encoding, não uma funcionalidade associada a uma edição de ECMAScript. Segundo a MDN, encode() está amplamente disponível nos navegadores desde janeiro de 2020 e também funciona em Web Workers. A sua presença no Node 24 não prova que seja suportada no navegador de destino.
Exemplos
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);Resultado
true 65,226,130,172 2 4
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.