CKTIS / JavaScript
TextEncoder — codificar texto como UTF-8
TextEncoder converte texto em bytes UTF-8. Descubra a diferença entre encode() e encodeInto() e o significado dos contadores read e written.
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
new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder é uma API do Encoding Standard, não faz parte do próprio ECMAScript. Suporta apenas UTF-8: o construtor não aceita qualquer etiqueta de codificação e encoding devolve "utf-8".
encode(input) cria um novo Uint8Array; se input for omitido, o texto é vazio. encodeInto(source, destination) escreve num Uint8Array existente. Devolve read em unidades de código UTF-16 e written em bytes. Se o espaço não for suficiente, não escreve uma sequência UTF-8 incompleta.
No exemplo, o buffer tem espaço para Aą, mas não para o emoji. Verifique a disponibilidade da API no navegador de destino; o ambiente do repositório não prova que o navegador a suporta.
Exemplos
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(","));Resultado
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
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.