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 Code-Einheit besteht, die an dem angegebenen Offset gefunden wird. Diese Methode erlaubt sowohl positive als auch negative Ganzzahlen. Negative Ganzzahlen zählen von dem letzten Zeichen der Zeichenkette rückwärts.
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 der Zeichenkette. Unterstützt relatives Indizieren vom Ende der Zeichenkette, wenn ein negativer Index übergeben wird; das heißt, wenn eine negative Zahl verwendet wird, wird das zurückgegebene Zeichen gefunden, indem man vom Ende der Zeichenkette rückwärts zählt.
Rückgabewert
Ein String bestehend aus der einzelnen UTF-16 Code-Einheit, die an der angegebenen Position gefunden wird. Gibt undefined zurück, wenn der angegebene Index nicht gefunden werden kann.
Beispiele
>Letztes Zeichen einer Zeichenkette zurückgeben
Das folgende Beispiel bietet eine Funktion, die das letzte Zeichen in einer angegebenen Zeichenkette 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 der Methoden
Hier vergleichen wir verschiedene Wege, das vorletzte Zeichen einer String zu wählen. Obwohl alle unten stehenden Methoden gültig sind, zeigt es die Prägnanz und Lesbarkeit der at() Methode.
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> |