String.prototype.at()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.
La méthode at()
prend un entier en argument et renvoie une nouvelle chaîne de caractères (String
) contenant le codet UTF-16 présent dans la chaîne courante à l'emplacement indiqué en argument. Cette méthode permet d'utiliser des arguments positifs ou négatifs. Lorsque le paramètre passé est un entier négatif, la recherche s'effectue depuis la fin de la chaîne de caractères.
Exemple interactif
Syntaxe
at(indice);
Paramètres
indice
-
L'indice (c'est-à-dire la position) du caractère de la chaîne de caractères qu'on souhaite récupérer. Les indices relatifs sont pris en charge et on peut ainsi utiliser un indice négatif. Dans ce cas, c'est le caractère situé à la position comptée depuis la fin de la chaîne qui est renvoyé.
Valeur de retour
Exemples
Renvoyer le dernier caractère d'une chaîne de caractères
Dans l'exemple qui suit, on fournit une fonction qui renvoie le dernier caractère trouvé dans une chaîne de caractères.
// Une fonction qui renvoie le dernier caractère d'une chaîne
function dernierCar(str) {
return str.at(-1);
}
let refFacture = "maFacture01";
console.log(dernierCar(refFacture));
// Affiche '1' dans la console
refFacture = "maFacture02";
console.log(dernierCar(refFacture));
// Affiche '2' dans la console
Comparaison de méthodes
On compare ici différentes méthodes pour sélectionner l'avant-dernier caractère d'une chaîne de caractères (String
). Bien que toutes les alternatives proposées ici soient valables, on pourra remarquer la concision et la lisibilité de la méthode at()
.
const maChaine = "Vers l'infini et au-delà !";
// En utilisant la propriété length et la méthode charAt()
const avecLength = maChaine.charAt(maChaine.length - 2);
console.log(avecLength); // Affiche 'à' dans la console
// En utilisant la méthode slice()
const avecSlice = maChaine.slice(-2, -1);
console.log(avecSlice); // Affiche 'à' dans la console
// En utilisant la méthode at()
const avecAt = maChaine.at(-2);
console.log(avecAt); // Affiche 'à' dans la console
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.at |
Compatibilité des navigateurs
BCD tables only load in the browser