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 Methode at() von TypedArray-Instanzen nimmt eine Ganzzahl entgegen und gibt das Element an diesem Index zurück. Dabei sind positive und negative Ganzzahlen zulässig. 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
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 zurückzugebenden Elements des typisierten Arrays, der in eine Ganzzahl umgewandelt wird. Ein negativer Index zählt vom Ende des typisierten Arrays rückwärts – wenn
index < 0, wird aufindex + array.lengthzugegriffen.
Rückgabewert
Das Element des typisierten Arrays am angegebenen Index. Wenn index < -array.length oder index >= array.length, wird immer undefined zurückgegeben, ohne zu versuchen, auf die entsprechende Eigenschaft zuzugreifen.
Beschreibung
Weitere Einzelheiten finden Sie unter Array.prototype.at(). Diese Methode ist nicht generisch und kann nur für Instanzen typisierter Arrays aufgerufen werden.
Beispiele
Den letzten Wert eines typisierten Arrays zurückgeben
Das folgende Beispiel zeigt eine Funktion, die das letzte Element eines angegebenen Arrays 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
Methoden vergleichen
Hier vergleichen wir verschiedene Möglichkeiten, das vorletzte Element eines TypedArray auszuwählen. Alle folgenden Methoden sind gültig; der Vergleich verdeutlicht jedoch, wie knapp und gut lesbar die Methode at() ist.
// 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 |