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

CKTIS / JavaScript

String.fromCodePoint — criar texto a partir de pontos de código

String.fromCodePoint cria uma cadeia de caracteres a partir de pontos de código Unicode, incluindo valores superiores a 0xFFFF. Codifica-os automaticamente em UTF-16; valores numéricos inválidos provocam RangeError.

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.fromCodePoint(...codePoints)

String.fromCodePoint(...codePoints) é um método estático de String, não um método de uma cadeia de caracteres individual. Devolve uma cadeia com os pontos de código fornecidos pela ordem dos argumentos. Sem argumentos, devolve "".

Cada argumento é convertido através de ToNumber. O resultado tem de ser um número inteiro entre 0 e 0x10FFFF, inclusive. Frações, NaN, infinitos e valores fora do intervalo provocam RangeError. Argumentos do tipo BigInt ou Symbol provocam TypeError durante a conversão.

Ao contrário de String.fromCharCode, que aceita unidades de código UTF-16, String.fromCodePoint aceita pontos de código completos. Um valor superior a 0xFFFF é codificado como um par de substitutos, aumentando em dois o .length da cadeia. .length conta unidades de código, não pontos de código nem caracteres visíveis.

O método também aceita valores substitutos 0xD800–0xDFFF; por isso, não garante um UTF-16 bem formado. Esta é uma API da linguagem ECMAScript, não uma API do navegador. Verifica a disponibilidade no ambiente de destino com typeof String.fromCodePoint === "function".

Exemplos

const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");

Resultado

A😀
3
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