TypedArray.prototype.at()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.
Die at() Methode von TypedArray Instanzen nimmt einen ganzzahligen Wert und gibt das Element an diesem Index zurück, wobei positive und negative Ganzzahlen zulässig sind. Negative Ganzzahlen zählen vom letzten Element im typisierten Array rückwärts. Diese Methode verwendet denselben Algorithmus wie Array.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, in eine Ganzzahl umgewandelt. Ein negativer Index zählt vom Ende des typisierten Arrays zurück — wenn
index < 0, wirdindex + array.lengthaufgerufen.
Rückgabewert
Das Element im typisierten Array, das dem gegebenen Index entspricht. Gibt immer undefined zurück, wenn index < -array.length oder index >= array.length, 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 Instanzen von typisierten Arrays aufgerufen werden.
Beispiele
Das letzte Element eines typisierten Arrays zurückgeben
Das folgende Beispiel bietet eine Funktion, die das letzte in einem angegebenen Array gefundene Element zurückgibt.
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 Möglichkeiten, das vorletzte (das vor dem letzten) Element eines TypedArray auszuwählen. Während alle unten aufgeführten Methoden gültig sind, wird die Prägnanz und Lesbarkeit der at() Methode hervorgehoben.
// 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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-%typedarray%.prototype.at |