Array.prototype.at()

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 zurckgegeben werden soll, konvertiert in eine Ganzzahl. Ein negativer Index zhlt vom Ende des Arrays rckwrts wenn index < 0, wird index + array.length abgerufen.

Rckgabewert

Das Element im Array, das dem angegebenen Index entspricht. Gibt immer undefined zurck, wenn index < -array.length oder index >= array.length ist, ohne zu versuchen, die entsprechende Eigenschaft zuzugreifen.

Beschreibung

Die at()-Methode entspricht der Klammernotation, wenn index eine nicht-negative Ganzzahl ist. Zum Beispiel geben array[0] und array.at(0) beide das erste Element zurck. Wenn jedoch Elemente vom Ende des Arrays gezhlt werden, knnen Sie array[-1] nicht wie in Python oder R verwenden, da alle Werte in den eckigen Klammern wrtlich als Zeichenfolgeneigenschaften behandelt werden. So wrden Sie array["-1"] lesen, was einfach eine normale Zeichenfolgeneigenschaft statt eines Array-Indexes ist.

Die bliche Methode besteht darin, auf length zuzugreifen und den Index daraus zu berechnen zum Beispiel array[array.length - 1]. Die at()-Methode ermglicht relatives Indizieren, sodass dies auf array.at(-1) verkrzt werden kann.

Durch die Kombination von at() mit with() knnen Sie ein Array sowohl mit lesenden als auch mit schreibenden Zugriffsoperationen unter Verwendung negativer Indizes nutzen.

Die at()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und ganzzahlig indizierte Eigenschaften hat.

Beispiele

Rckgabe des letzten Werts eines Arrays

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

// Our array with items
const cart = ["apple", "banana", "pear"];

// A function which returns the last item of a given array
function 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' array
cart.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 eines Array auszuwhlen. Whrend alle unten gezeigten Methoden gltig sind, hebt dieses Beispiel die Krze und Lesbarkeit der at()-Methode hervor.

// Our array with items
const colors = ["red", "green", "blue"];

// Using length property
const lengthWay = colors[colors.length - 2];
console.log(lengthWay); // 'green'

// Using slice() method. Note an array is returned
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // 'green'

// Using at() method
const atWay = colors.at(-2);
console.log(atWay); // 'green'

Aufrufen von at() bei Nicht-Array-Objekten

Die at()-Methode liest die length-Eigenschaft von this 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-Kompatibilitt

Siehe auch

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