Dieat()-Methode vonTypedArray Instanzen nimmt einen ganzzahligen Wert entgegen und gibt das Element an diesem Index zurück, wobei sowohl positive als auch negative Ganzzahlen erlaubt sind. Negative Ganzzahlen zählen rückwärts vom letzten Element des typisierten Arrays. Diese Methode verwendet denselben Algorithmus wieArray.prototype.at().

Probieren Sie es aus

const int8 = new Int8Array([0, 10, -10, 20, -30, 40, -50]);let index = 1;console.log(`An index of ${index} returns the item ${int8.at(index)}`);// Expected output: "An index of 1 returns the item 10"index = -2;console.log(`An index of ${index} returns the item ${int8.at(index)}`);// Expected output: "An index of -2 returns the item 40"

Syntax

at(index)

Parameter

index

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

Rückgabewert

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

Beschreibung

SieheArray.prototype.at() für weitere Details. Diese Methode ist nicht generisch und kann nur auf Instanzen eines typisierten Arrays aufgerufen werden.

Beispiele

Das letzte Element eines typisierten Arrays zurückgeben

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

const uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);// A function which returns the last item of a given arrayfunction returnLast(arr) {  return arr.at(-1);}const lastItem = returnLast(uint8);console.log(lastItem); // 18

Vergleich von Methoden

Hier vergleichen wir verschiedene Möglichkeiten, um das vorletzte Element (das letzte, aber eins) einesTypedArray auszuwählen. Während alle untenstehenden Methoden gültig sind, hebt dies die Prägnanz und Lesbarkeit derat()-Methode hervor.

// Our typed array with valuesconst uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);// Using length propertyconst lengthWay = uint8[uint8.length - 2];console.log(lengthWay); // 11// Using slice() method. Note an array is returnedconst sliceWay = uint8.slice(-2, -1);console.log(sliceWay[0]); // 11// Using at() methodconst atWay = uint8.at(-2);console.log(atWay); // 11

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonTypedArray.prototype.at incore-js
• es-shims Polyfill vonTypedArray.prototype.at
• JavaScript typisierte Arrays Leitfaden
• TypedArray
• TypedArray.prototype.findIndex()
• TypedArray.prototype.indexOf()
• TypedArray.prototype.with()
• Array.prototype.at()
• String.prototype.at()