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

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.

Fontes