CKTIS / JavaScript
String.prototype.charAt — unité de code UTF-16 à un indice
La méthode charAt() renvoie une chaîne contenant une unité de code UTF-16 à l’indice de base zéro, ou une chaîne vide si l’indice est hors limites. Elle ne garantit pas de renvoyer un caractère 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.charAt(index)String.prototype.charAt lit l’unité de code UTF-16 à l’indice de base zéro. Elle renvoie une valeur primitive de type string : une chaîne d’une unité de code, ou "" lorsque l’indice est hors limites. Elle ne modifie pas la chaîne d’origine.
L’argument index est converti avec ToIntegerOrInfinity : les fractions sont tronquées vers zéro, tandis qu’un argument omis, undefined et NaN correspondent à l’indice 0. Après conversion, un indice négatif ne compte pas à rebours depuis la fin ; il produit "". Les deux infinis produisent également "".
Une unité de code n’est pas nécessairement un point de code Unicode complet ni un caractère perçu par l’utilisateur. L’emoji de l’exemple occupe deux unités de code ; text.charAt(1) ne renvoie que son premier substitut. N’utilisez pas cette méthode pour extraire des caractères visuels complets.
La méthode rejette d’abord null et undefined comme valeur de this, en lançant une TypeError, puis convertit le récepteur en chaîne. Elle peut donc être empruntée, par exemple avec String.prototype.charAt.call(123, 1), qui renvoie "2".
Exemples
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");Résultat
A A B "" "" true
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.