CKTIS / JavaScript
String.prototype.codePointAt — lire un point de code
La méthode codePointAt(pos) renvoie la valeur numérique du point de code qui commence à un index UTF-16 donné. Elle reconnaît les paires de substituts, mais l’index désigne toujours une unité de code, et non le caractère suivant visible à l’écran.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.codePointAt(pos)String.prototype.codePointAt lit le point de code à l’index pos, qui commence à zéro. La méthode renvoie un Number compris entre 0 et 0x10FFFF, ou undefined si l’index se trouve en dehors de la chaîne. Elle ne modifie pas la chaîne.
Les index et length correspondent aux unités de code UTF-16. Si une paire de substituts valide commence à cet index, la méthode combine ses deux unités en un seul point de code. Sinon, elle renvoie la valeur d’une seule unité, y compris celle d’un substitut isolé. Un appel sur le second élément d’une paire renvoie la valeur du substitut de fin ; il ne revient pas au début de la paire. En revanche, charCodeAt lit toujours une unité et renvoie NaN en dehors de la chaîne.
La méthode convertit pos avec ToIntegerOrInfinity avant de vérifier les bornes : un argument omis ou NaN équivaut à 0, et les parties fractionnaires sont tronquées vers zéro. Un index obtenu qui est négatif, infini ou supérieur ou égal à length donne undefined. Pour une chaîne vide, tout index obtenu après une conversion réussie est hors limites. Si la conversion lève une exception, celle-ci se propage même pour une chaîne vide : par exemple, "".codePointAt(0n) lève une exception de type TypeError.
Ne considère pas l’incrémentation de l’index de un comme un parcours des points de code : elle peut mener au milieu d’une paire. Un point de code ne correspond pas nécessairement à un caractère complet visible à l’écran. Il s’agit d’une méthode ECMAScript, pas d’une API de navigateur ; la norme seule ne permet pas d’établir sa prise en charge dans un navigateur particulier.
Exemples
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));Résultat
4 128512 55357 56832 undefined
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.