CKTIS / JavaScript
String.prototype.codePointAt — leer un punto de código
El método codePointAt(pos) devuelve el valor numérico del punto de código que comienza en un índice UTF-16 especificado. Reconoce pares sustitutos, pero el índice sigue señalando una unidad de código, no el siguiente carácter visible en pantalla.
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.codePointAt(pos)String.prototype.codePointAt lee el punto de código en el índice pos, que empieza en cero. Devuelve un Number del rango 0–0x10FFFF o undefined si el índice está fuera de la cadena. No modifica la cadena.
Los índices y length corresponden a unidades de código UTF-16. Si en el índice comienza un par sustituto válido, el método combina sus dos unidades en un punto de código. En caso contrario, devuelve el valor de una sola unidad, incluso si es un sustituto aislado. Al llamarlo en el segundo elemento de un par, devuelve el valor del sustituto final; no retrocede hasta el inicio del par. En cambio, charCodeAt siempre lee una unidad y devuelve NaN fuera de la cadena.
El método convierte pos mediante ToIntegerOrInfinity antes de comprobar los límites: si el argumento se omite o es NaN, equivale a 0, y las partes fraccionarias se truncan hacia cero. Si el índice resultante es negativo, infinito o no es menor que length, el resultado es undefined. En una cadena vacía, cualquier índice obtenido tras una conversión correcta queda fuera de rango. Si la conversión lanza una excepción, esta se propaga incluso para una cadena vacía: por ejemplo, "".codePointAt(0n) lanza un TypeError.
No trates el aumento del índice en uno como un recorrido por puntos de código: así se puede llegar al interior de un par. Además, un punto de código no tiene por qué representar un carácter completo visible en pantalla. Es un método de ECMAScript, no una API del navegador; el estándar por sí solo no confirma que sea compatible con un navegador concreto.
Ejemplos
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
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.