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 eine neue String zurück, die aus dem einzelnen UTF-16-Code-Einheit besteht, die an der angegebenen Stelle zu finden ist. Diese Methode ermöglicht sowohl positive als auch negative Ganzzahlen. Negative Ganzzahlen zählen vom letzten Zeichen der Zeichenkette 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

js
at(index)

Parameter

index

Der Index (Position) des Zeichenkettensymbols, das zurückgegeben werden soll. Unterstützt relatives Indizieren vom Ende der Zeichenkette aus, wenn ein negativer Index übergeben wird; d.h. wenn eine negative Zahl verwendet wird, wird das zurückgegebene Zeichen durch Zurückzählen vom Ende der Zeichenkette gefunden.

Rückgabewert

Ein String, der aus der einzelnen UTF-16-Code-Einheit besteht, die an der angegebenen Position zu finden ist. Gibt undefined zurück, wenn der angegebene Index nicht gefunden werden kann.

Beispiele

Das letzte Zeichen einer Zeichenkette zurückgeben

Das folgende Beispiel stellt eine Funktion bereit, die das letzte Zeichen in einer spezifizierten Zeichenkette zurückgibt.

js
// 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, um das vorletzte (vor dem letzten) Zeichen eines String auszuwählen. Obwohl alle unten stehenden Methoden gültig sind, wird die Prägnanz und Lesbarkeit der at() Methode hervorgehoben.

js
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

Browser-Kompatibilität

Siehe auch