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

CKTIS / JavaScript

String.prototype.charCodeAt — valor da unidade de código UTF-16

O método charCodeAt devolve o valor numérico da unidade de código UTF-16 no índice indicado, ou NaN se o índice estiver fora da cadeia. Nem sempre devolve um ponto de código Unicode completo.

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.charCodeAt(index)

String.prototype.charCodeAt lê uma unidade de código UTF-16. Os índices começam em 0. Se o índice estiver dentro do intervalo válido, o resultado é um Number entre 0 e 65535. O método não altera a cadeia.

O argumento index é convertido num número e a parte fracionária é truncada na direção de zero. Se o argumento for omitido, ou for undefined ou NaN, corresponde ao índice 0. O método só verifica os limites se a conversão for bem-sucedida. Se o índice obtido estiver fora do intervalo válido, como acontece com um número inteiro negativo ou um valor infinito, o método devolve NaN. Numa cadeia vazia, qualquer índice obtido após a conversão fica fora do intervalo válido, mas "".charCodeAt(0n) lança um TypeError durante a conversão. Os índices negativos não contam a partir do fim.

Não confundas uma unidade de código com um ponto de código Unicode. No exemplo, A ocupa uma unidade de código, enquanto o emoji ocupa duas: 55357 e 56832. charCodeAt lê cada uma separadamente. Usa codePointAt para ler o ponto de código que começa num determinado índice; o índice continua a ser medido em unidades de código UTF-16.

Este é um método da biblioteca padrão ECMAScript, não uma API Web do navegador. Também pode operar sobre outros valores após a conversão para cadeia através de String.prototype.charCodeAt.call(value, index), mas null e undefined como valor de value provocam um TypeError.

Exemplos

const text = "A\uD83D\uDE00";
console.log(text.charCodeAt(0));
console.log(text.charCodeAt(1));
console.log(text.charCodeAt(2));
console.log(text.charCodeAt(3));
console.log(text.charCodeAt());

Resultado

65
55357
56832
NaN
65

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