Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes