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

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.

Fontes