CKTIS / JavaScript
String.prototype.codePointAt — ler um ponto de código
O método codePointAt(pos) devolve o valor numérico do ponto de código que começa num índice UTF-16 especificado. Reconhece pares substitutos, mas o índice continua a identificar uma unidade de código, não o carácter seguinte visível no ecrã.
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.codePointAt(pos)String.prototype.codePointAt lê o ponto de código no índice pos, contado a partir de zero. Devolve um Number no intervalo 0–0x10FFFF ou undefined se o índice estiver fora da cadeia. Não altera a cadeia.
Os índices e length referem-se a unidades de código UTF-16. Se um par substituto válido começar nesse índice, o método combina as duas unidades num único ponto de código. Caso contrário, devolve o valor de uma unidade, incluindo o de um substituto isolado. Uma chamada no segundo elemento de um par devolve o valor do substituto final; não recua até ao início do par. Em contrapartida, charCodeAt lê sempre uma unidade e devolve NaN fora da cadeia.
O método converte pos através de ToIntegerOrInfinity antes de verificar os limites: se o argumento for omitido ou for NaN, equivale a 0, e as partes fracionárias são truncadas em direção a zero. Um índice resultante negativo, infinito ou que não seja inferior a length produz undefined. Numa cadeia vazia, todos os índices obtidos após uma conversão bem-sucedida ficam fora dos limites. Se a conversão lançar uma exceção, esta propaga-se mesmo para uma cadeia vazia: por exemplo, "".codePointAt(0n) lança um TypeError.
Não consideres o incremento do índice em um como uma forma de percorrer pontos de código: isso pode levar ao meio de um par. Além disso, um ponto de código não tem necessariamente de corresponder a um carácter completo visível no ecrã. Este é um método ECMAScript, não uma API do navegador; por si só, a norma não comprova o suporte num navegador específico.
Exemplos
const text = "A\u{1F600}B";
console.log(text.length);
console.log(text.codePointAt(1));
console.log(text.charCodeAt(1));
console.log(text.codePointAt(2));
console.log(text.codePointAt(4));Resultado
4 128512 55357 56832 undefined
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.