WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.at: Element über relativen Index

Die Methode at liest ein Array-Element und zählt bei negativem Index ohne manuelle length-Rechnung vom Ende.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.at(index)

array.at(index) wandelt index durch Abschneiden des Nachkommateils in eine Ganzzahl um. Ein nicht negativer Index zählt vom Anfang, ein negativer relativ zu array.length; -1 ist das letzte Element. Die Methode ist für array-ähnliche Empfänger generisch und verändert sie nicht.

Liegt der berechnete Index außerhalb, ist das Ergebnis undefined, ohne die Eigenschaft zu lesen. Auch eine Lücke ergibt undefined. NaN wirkt wie Index 0, Infinity liegt außerhalb.

Ein Empfänger null oder undefined löst TypeError aus. Anders als array[-1], das die Eigenschaft "-1" sucht, indiziert at(-1) wirklich vom Ende. Das Beispiel zeigt negativen, ungültigen und gebrochenen Index.

Beispiele

const values = ["first", "middle", "last"];
console.log(values.at(-1));
console.log(values.at(-4));
console.log(values.at(1.9));

Ergebnis

last
undefined
middle

Quellen