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

CKTIS / JavaScript

String.fromCharCode — criar texto a partir de unidades de código UTF-16

String.fromCharCode cria uma cadeia de caracteres a partir das unidades de código UTF-16 fornecidas. Não interpreta os argumentos como pontos de código Unicode completos: os caracteres fora do Plano Multilingue Básico requerem um par substituto.

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

String.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) é um método estático do construtor String, não um método de uma cadeia de caracteres individual. Devolve uma nova cadeia que contém unidades de código UTF-16 pela ordem dos argumentos. Sem argumentos, devolve "". Faz parte do ECMAScript, não de uma API do navegador.

Cada argumento passa por ToUint16: é convertido num número, a parte fracionária é truncada em direção a zero e o resultado é reduzido módulo 65536. NaN, Infinity e -Infinity produzem uma unidade de código com o valor 0. Os valores fora do intervalo não causam, por si só, um RangeError; por exemplo, 0x10041 produz a mesma unidade de código que 65. Converter um Symbol ou um BigInt causa um TypeError.

Uma unidade de código nem sempre representa um caráter Unicode completo. Para o ponto de código 0x1F600, fornece o par substituto 0xD83D, 0xDE00; o resultado tem um length de 2. Se os teus valores de entrada forem pontos de código, usa String.fromCodePoint. String.fromCharCode não valida os pares substitutos e pode criar um substituto isolado.

O exemplo apresenta letras, um par substituto, a redução módulo e uma chamada sem argumentos. Não uses este método como descodificador de bytes UTF-8.

Exemplos

const text = String.fromCharCode(65, 66, 67);
const emoji = String.fromCharCode(0xD83D, 0xDE00);
console.log(text);
console.log(emoji === String.fromCodePoint(0x1F600));
console.log(emoji.length);
console.log(String.fromCharCode(0x10041) === "A");
console.log(String.fromCharCode() === "");

Resultado

ABC
true
2
true
true

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