Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.charCodeAt — valeur d’unité de code UTF-16

La méthode charCodeAt renvoie la valeur numérique de l’unité de code UTF-16 à un index, ou NaN si l’index est hors de la chaîne. Elle ne renvoie pas toujours un point de code Unicode complet.

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

String.prototype.charCodeAt lit une unité de code UTF-16. Les index commencent à 0. Si l’index est dans les limites de la chaîne, le résultat est un Number compris entre 0 et 65535. La méthode ne modifie pas la chaîne.

L’argument index est converti en nombre, et sa partie fractionnaire est tronquée vers zéro. Un argument omis, undefined et NaN correspondent à l’index 0. La méthode ne vérifie les limites qu’une fois la conversion réussie. Si l’index obtenu est hors limites, par exemple s’il s’agit d’un entier négatif ou d’une valeur infinie, la méthode renvoie NaN. Dans une chaîne vide, tout index obtenu après conversion est hors limites, mais "".charCodeAt(0n) lève une exception TypeError lors de la conversion. Les index négatifs ne comptent pas à partir de la fin.

Ne confondez pas une unité de code avec un point de code Unicode. Dans l’exemple, A occupe une unité de code, tandis que l’emoji en occupe deux : 55357 et 56832. charCodeAt lit chacune séparément. Utilisez codePointAt pour lire le point de code qui commence à un index donné ; l’index est toujours mesuré en unités de code UTF-16.

Il s’agit d’une méthode de la bibliothèque standard ECMAScript, et non d’une API Web du navigateur. Elle peut aussi s’appliquer à d’autres valeurs après conversion en chaîne avec String.prototype.charCodeAt.call(value, index), mais null et undefined comme valeur de value provoquent un TypeError.

Exemples

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());

Résultat

65
55357
56832
NaN
65

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.

Sources