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.

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 an dem angegebenen Offset befindet. Diese Methode erlaubt sowohl positive als auch negative Ganzzahlen. Negative Zahlen zählen von dem letzten Zeichen der Zeichenkette aus zurück.

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 (die Position) des Zeichenkettenzeichens, das zurückgegeben werden soll. Unterstützt relatives Indexieren vom Ende der Zeichenkette aus, wenn ein negativer Index übergeben wird; das heißt, wenn eine negative Zahl verwendet wird, wird das zurückgegebene Zeichen ermittelt, indem vom Ende der Zeichenkette aus rückwärts gezählt wird.

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 einer Zeichenkette zurückgeben

Das folgende Beispiel bietet eine Funktion, die das letzte gefundene 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 von Methoden

Hier vergleichen wir verschiedene Möglichkeiten, das vorletzte Zeichen (letztes plus eins) eines String auszuwählen. Während alle untenstehenden Methoden gültig sind, hebt es die Prägnanz und Lesbarkeit der at()-Methode hervor.

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

Specification
ECMAScript® 2026 Language Specification # sec-string.prototype.at