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

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.

Sources