[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/at [Back]  [Original]

String.prototype.at() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.prototype.at()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2022.

La mthode at() prend un entier en argument et renvoie une nouvelle chane de caractres (String) contenant le codet UTF-16 prsent dans la chane courante l'emplacement indiqu en argument. Cette mthode permet d'utiliser des arguments positifs ou ngatifs. Lorsque le paramtre pass est un entier ngatif, la recherche s'effectue depuis la fin de la chane de caractres.

Dans cet article

Exemple interactif

const sentence = "The quick brown fox jumps over the lazy dog.";

let index = 5;

console.log(`An index of ${index} returns the character ${sentence.at(index)}`);
// Expected output: "An index of 5 returns the character u"

index = -4;

console.log(`An index of ${index} returns the character ${sentence.at(index)}`);
// Expected output: "An index of -4 returns the character d"

Syntaxe

js
at(indice);

Paramtres

indice

L'indice (c'est--dire la position) du caractre de la chane de caractres qu'on souhaite rcuprer. Les indices relatifs sont pris en charge et on peut ainsi utiliser un indice ngatif. Dans ce cas, c'est le caractre situ la position compte depuis la fin de la chane qui est renvoy.

Valeur de retour

Une chane de caractres (String) contenant un unique codet UTF-16 situ la position indique. Renvoie undefined si l'indice indiqu ne peut tre trouv dans la chane de caractres.

Exemples

Renvoyer le dernier caractre d'une chane de caractres

Dans l'exemple qui suit, on fournit une fonction qui renvoie le dernier caractre trouv dans une chane de caractres.

js
// Une fonction qui renvoie le dernier caractre d'une chane
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 mthodes

On compare ici diffrentes mthodes pour slectionner l'avant-dernier caractre d'une chane de caractres (String). Bien que toutes les alternatives proposes ici soient valables, on pourra remarquer la concision et la lisibilit de la mthode at().

js
const maChaine = "Vers l'infini et au-del !";

// En utilisant la proprit length et la mthode charAt()
const avecLength = maChaine.charAt(maChaine.length - 2);
console.log(avecLength); // Affiche '' dans la console

// En utilisant la mthode slice()
const avecSlice = maChaine.slice(-2, -1);
console.log(avecSlice); // Affiche '' dans la console

// En utilisant la mthode at()
const avecAt = maChaine.at(-2);
console.log(avecAt); // Affiche '' dans la console

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.prototype.at

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page