Dieat()-Methode vonArray-Instanzen nimmt einen ganzzahligen Wert und gibt das Element an diesem Index zurück, wobei sowohl positive als auch negative Ganzzahlen verwendet werden können. Negative Ganzzahlen zählen vom letzten Element des Arrays rückwärts.

Probieren Sie es aus

const array = [5, 12, 8, 130, 44];let index = 2;console.log(`An index of ${index} returns ${array.at(index)}`);// Expected output: "An index of 2 returns 8"index = -2;console.log(`An index of ${index} returns ${array.at(index)}`);// Expected output: "An index of -2 returns 130"

Syntax

at(index)

Parameter

index

Nullbasierter Index des Array-Elements, das zurückgegeben werden soll,konvertiert in eine Ganzzahl. Ein negativer Index zählt vom Ende des Arrays rückwärts — wennindex < 0, wirdindex + array.length abgerufen.

Rückgabewert

Das Element im Array, das dem angegebenen Index entspricht. Gibt immerundefined zurück, wennindex < -array.length oderindex >= array.length ist, ohne zu versuchen, die entsprechende Eigenschaft zuzugreifen.

Beschreibung

Dieat()-Methode entspricht der Klammernotation, wennindex eine nicht-negative Ganzzahl ist. Zum Beispiel gebenarray[0] undarray.at(0) beide das erste Element zurück. Wenn jedoch Elemente vom Ende des Arrays gezählt werden, können Siearray[-1] nicht wie in Python oder R verwenden, da alle Werte in den eckigen Klammern wörtlich als Zeichenfolgeneigenschaften behandelt werden. So würden Siearray["-1"] lesen, was einfach eine normale Zeichenfolgeneigenschaft statt eines Array-Indexes ist.

Die übliche Methode besteht darin, auflength zuzugreifen und den Index daraus zu berechnen — zum Beispielarray[array.length - 1]. Dieat()-Methode ermöglicht relatives Indizieren, sodass dies aufarray.at(-1) verkürzt werden kann.

Durch die Kombination vonat() mitwith() können Sie ein Array sowohl mit lesenden als auch mit schreibenden Zugriffsoperationen unter Verwendung negativer Indizes nutzen.

Dieat()-Methode istgenerisch. Sie erwartet nur, dass derthis-Wert einelength-Eigenschaft und ganzzahlig indizierte Eigenschaften hat.

Beispiele

Rückgabe des letzten Werts eines Arrays

Das folgende Beispiel bietet eine Funktion, die das letzte Element in einem angegebenen Array zurückgibt.

// Our array with itemsconst cart = ["apple", "banana", "pear"];// A function which returns the last item of a given arrayfunction returnLast(arr) {  return arr.at(-1);}// Get the last item of our array 'cart'const item1 = returnLast(cart);console.log(item1); // 'pear'// Add an item to our 'cart' arraycart.push("orange");const item2 = returnLast(cart);console.log(item2); // 'orange'

Vergleichen von Methoden

Dieses Beispiel vergleicht verschiedene Methoden, um das vorletzte (vor dem letzten) Element einesArray auszuwählen. Während alle unten gezeigten Methoden gültig sind, hebt dieses Beispiel die Kürze und Lesbarkeit derat()-Methode hervor.

// Our array with itemsconst colors = ["red", "green", "blue"];// Using length propertyconst lengthWay = colors[colors.length - 2];console.log(lengthWay); // 'green'// Using slice() method. Note an array is returnedconst sliceWay = colors.slice(-2, -1);console.log(sliceWay[0]); // 'green'// Using at() methodconst atWay = colors.at(-2);console.log(atWay); // 'green'

Aufrufen von at() bei Nicht-Array-Objekten

Dieat()-Methode liest dielength-Eigenschaft vonthis und berechnet den zuzugreifenden Index.

const arrayLike = {  length: 2,  0: "a",  1: "b",  2: "c", // ignored by at() since length is 2};console.log(Array.prototype.at.call(arrayLike, 0)); // "a"console.log(Array.prototype.at.call(arrayLike, 2)); // undefined

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonArray.prototype.at incore-js
• es-shims Polyfill vonArray.prototype.at
• Leitfaden zu indizierten Sammlungen
• Array
• Array.prototype.findIndex()
• Array.prototype.indexOf()
• Array.prototype.with()
• TypedArray.prototype.at()
• String.prototype.at()