CKTIS / JavaScript
String.prototype.charAt — unidade de código UTF-16 num índice
O método charAt() devolve uma cadeia com uma unidade de código UTF-16 no índice de base zero, ou uma cadeia vazia se o índice estiver fora do intervalo válido. Não garante a devolução de um carácter 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.charAt(index)String.prototype.charAt lê a unidade de código UTF-16 no índice de base zero. Devolve um valor primitivo do tipo string: uma cadeia com uma unidade de código ou "" quando o índice está fora do intervalo válido. Não altera a cadeia original.
O argumento index é convertido através de ToIntegerOrInfinity: as frações são truncadas na direção de zero, enquanto um argumento omitido, undefined e NaN correspondem ao índice 0. Após a conversão, um índice negativo não conta para trás a partir do fim; produz "". Os dois infinitos também produzem "".
Uma unidade de código não é necessariamente um ponto de código Unicode completo nem um carácter percebido pelo utilizador. O emoji do exemplo ocupa duas unidades de código; text.charAt(1) devolve apenas o seu primeiro substituto. Não utilize este método para extrair caracteres visuais completos.
O método rejeita primeiro null e undefined como valor de this, lançando um TypeError, e depois converte o recetor numa cadeia. Por isso, pode ser emprestado, por exemplo através de String.prototype.charAt.call(123, 1), que devolve "2".
Exemplos
const text = "A\uD83D\uDE00B";
console.log(text.charAt(0));
console.log(text.charAt());
console.log(text.charAt(3.9));
console.log(JSON.stringify(text.charAt(-1)));
console.log(JSON.stringify(text.charAt(4)));
console.log(text.charAt(1) === "\uD83D");Resultado
A A B "" "" 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.