TypedArray.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 TypedArray Instanzen nimmt einen ganzzahligen Wert und gibt das Element an diesem Index zurück, wobei sowohl positive als auch negative Ganzzahlen zulässig sind. Negative Ganzzahlen zählen vom letzten Element des typisierten Arrays rückwärts. Diese Methode verwendet denselben Algorithmus wie Array.prototype.at().

Probieren Sie es aus

Syntax

js
at(index)

Parameter

index

Nullbasierter Index des Elements im typisierten Array, das zurückgegeben werden soll, umgewandelt in eine Ganzzahl. Ein negativer Index zählt vom Ende des typisierten Arrays zurück — wenn index < 0, wird auf index + array.length zugegriffen.

Rückgabewert

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

Beschreibung

Siehe Array.prototype.at() für weitere Details. Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Rückgabe des letzten Werts eines typisierten Arrays

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

js
const uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);

// A function which returns the last item of a given array
function returnLast(arr) {
  return arr.at(-1);
}

const lastItem = returnLast(uint8);
console.log(lastItem); // 18

Vergleich von Methoden

Hier vergleichen wir verschiedene Wege, um das vorletzte Element (das letzte, aber eins) eines TypedArray auszuwählen. Obwohl alle unten stehenden Methoden gültig sind, wird die Prägnanz und Lesbarkeit der at()-Methode hervorgehoben.

js
// Our typed array with values
const uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);

// Using length property
const lengthWay = uint8[uint8.length - 2];
console.log(lengthWay); // 11

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

// Using at() method
const atWay = uint8.at(-2);
console.log(atWay); // 11

Spezifikationen

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.at

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch