String.prototype.at()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.
Die at()-Methode von String-Werten nimmt einen ganzzahligen Wert und gibt einen neuen String zurück, der aus der einzelnen UTF-16-Codeeinheit besteht, die sich am angegebenen Offset befindet. Diese Methode ermöglicht positive und negative Ganzzahlen. Negative Ganzzahlen zählen rückwärts vom letzten Zeichen des Strings.
Probieren Sie es aus
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"
Syntax
at(index)
Parameter
index-
Der Index (Position) des zurückzugebenden Zeichen im String. Unterstützt relatives Indexieren vom Ende des Strings, wenn ein negativer Index übergeben wird; d.h. wenn eine negative Zahl verwendet wird, wird das zurückgegebene Zeichen durch Zählen vom Ende des Strings gefunden.
Rückgabewert
Ein String, der aus der einzelnen UTF-16-Codeeinheit besteht, die sich an der angegebenen Position befindet. Gibt undefined zurück, wenn der angegebene Index nicht gefunden werden kann.
Beispiele
Das letzte Zeichen eines Strings zurückgeben
Das folgende Beispiel stellt eine Funktion bereit, die das letzte gefundene Zeichen in einem angegebenen String zurückgibt.
// A function which returns the last character of a given string
function returnLast(str) {
return str.at(-1);
}
let invoiceRef = "my-invoice01";
console.log(returnLast(invoiceRef)); // '1'
invoiceRef = "my-invoice02";
console.log(returnLast(invoiceRef)); // '2'
Vergleich von Methoden
Hier vergleichen wir verschiedene Möglichkeiten, das vorletzte (letzte, aber eines) Zeichen eines String auszuwählen. Obwohl alle unten stehenden Methoden gültig sind, wird die Prägnanz und Lesbarkeit der at()-Methode hervorgehoben.
const myString = "Every green bus drives fast.";
// Using length property and charAt() method
const lengthWay = myString.charAt(myString.length - 2);
console.log(lengthWay); // 't'
// Using slice() method
const sliceWay = myString.slice(-2, -1);
console.log(sliceWay); // 't'
// Using at() method
const atWay = myString.at(-2);
console.log(atWay); // 't'
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.at |