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.