CKTIS / JavaScript
String.prototype.charCodeAt — valor de unidad de código UTF-16
El método charCodeAt devuelve el valor numérico de la unidad de código UTF-16 situada en un índice, o NaN si el índice queda fuera de la cadena. No siempre devuelve un punto de código Unicode completo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
string.charCodeAt(index)String.prototype.charCodeAt lee una unidad de código UTF-16. Los índices empiezan en 0. Si el índice está dentro del rango de la cadena, el resultado es un Number entre 0 y 65535. El método no modifica la cadena.
El argumento index se convierte en un número y su parte fraccionaria se trunca hacia cero. Si se omite el argumento, o si es undefined o NaN, se usa el índice 0. El método comprueba el rango solo si la conversión se realiza correctamente. Si el índice resultante queda fuera de rango, como ocurre con un entero negativo o un valor infinito, el método devuelve NaN. En una cadena vacía, todo índice obtenido tras la conversión queda fuera de rango, pero "".charCodeAt(0n) lanza un TypeError durante la conversión. Los índices negativos no cuentan desde el final.
No confundas una unidad de código con un punto de código Unicode. En el ejemplo, A ocupa una unidad de código, mientras que el emoji ocupa dos: 55357 y 56832. charCodeAt lee cada una por separado. Usa codePointAt para leer el punto de código que empieza en un índice determinado; el índice sigue midiéndose en unidades de código UTF-16.
Es un método de la biblioteca estándar de ECMAScript, no una API web del navegador. También puede operar sobre otros valores después de convertirlos a cadena mediante String.prototype.charCodeAt.call(value, index), pero si value es null o undefined se produce un TypeError.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.