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

CKTIS / JavaScript

String.prototype.at — lire une unité de code UTF-16 par index

String.prototype.at(index) renvoie une chaîne contenant une unité de code UTF-16. Les indices négatifs comptent depuis la fin ; une position hors limites renvoie undefined.

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

String.prototype.at(index) lit une unité de code UTF-16 sans modifier la chaîne. Les indices commencent à 0 ; -1 désigne la dernière unité et -2 l’avant-dernière. Le résultat est une chaîne de longueur 1, ou undefined si la position calculée est hors limites. Pour une chaîne vide, la méthode renvoie undefined si la conversion de l’indice réussit. L’indice est converti avant la vérification des limites, donc "".at(0n) lève une exception TypeError.

L’argument est converti en nombre entier en tronquant sa partie fractionnaire vers zéro. Un argument omis, undefined et NaN correspondent à l’indice 0 ; les infinis renvoient undefined. Pour un indice négatif, la position est string.length + index après conversion.

Contrairement à at(), charAt() ne compte pas à rebours pour les indices négatifs et renvoie "" hors limites. L’expression text[-1] lit une propriété nommée "-1", et non la dernière unité de la chaîne.

Une unité de code UTF-16 n’est pas forcément un caractère Unicode complet ni un caractère perçu par l’utilisateur : "😀".at(0) renvoie uniquement la première moitié d’une paire de substituts. Cette méthode fait partie d’ECMAScript 2022, et non d’une API de navigateur. La spécification ne définit pas les versions de navigateurs compatibles ; vérifiez les environnements cibles avant le déploiement, par exemple avec typeof String.prototype.at === "function".

Exemples

const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);

Résultat

J
t
p
undefined
true
1

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