Array.prototype.lastIndexOf()

searchElement

Element, das im Array gesucht werden soll.

fromIndex Optional

Null-basierter Index, ab dem rückwärts gesucht werden soll, in eine Ganzzahl umgewandelt.

• Ein negativer Index zählt vom Ende des Arrays rückwärts — wenn -array.length <= fromIndex < 0, wird fromIndex + array.length verwendet.
• Wenn fromIndex < -array.length, wird das Array nicht durchsucht und -1 wird zurückgegeben. Es kann konzeptionell betrachtet werden, als würde man an einer nicht existenten Position vor dem Anfang des Arrays beginnen und von dort rückwärts gehen. Es gibt keine Array-Elemente auf dem Weg, daher wird searchElement nie gefunden.
• Wenn fromIndex >= array.length oder fromIndex ausgelassen wird oder undefined ist, wird array.length - 1 verwendet, sodass das gesamte Array durchsucht wird. Es kann konzeptionell betrachtet werden, als würde man an einer nicht existenten Position über dem Ende des Arrays beginnen und von dort rückwärts gehen. Schließlich erreicht man die tatsächliche Endposition des Arrays und beginnt dann, rückwärts durch die tatsächlichen Array-Elemente zu suchen.

Der letzte Index von searchElement im Array; -1, wenn nicht gefunden.

Die lastIndexOf() Methode vergleicht searchElement mit den Elementen des Arrays unter Verwendung von strikter Gleichheit (der gleiche Algorithmus, der von dem === Operator verwendet wird). NaN Werte werden nie als gleich verglichen, daher gibt lastIndexOf() immer -1 zurück, wenn searchElement NaN ist.

Die lastIndexOf() Methode überspringt leere Plätze in dünn besetzten Arrays.

Die lastIndexOf() Methode ist generisch. Sie erwartet lediglich, dass der this Wert eine length Eigenschaft und integer-basierte Eigenschaften hat.

Das folgende Beispiel verwendet lastIndexOf(), um Werte in einem Array zu lokalisieren.

const numbers = [2, 5, 9, 2];
numbers.lastIndexOf(2); // 3
numbers.lastIndexOf(7); // -1
numbers.lastIndexOf(2, 3); // 3
numbers.lastIndexOf(2, 2); // 0
numbers.lastIndexOf(2, -2); // 0
numbers.lastIndexOf(2, -1); // 3

Sie können lastIndexOf() nicht verwenden, um nach NaN zu suchen.

const array = [NaN];
array.lastIndexOf(NaN); // -1

Das folgende Beispiel verwendet lastIndexOf, um alle Indizes eines Elements in einem gegebenen Array zu finden. Dabei wird push() verwendet, um sie einem anderen Array hinzuzufügen, sobald sie gefunden werden.

const indices = [];
const array = ["a", "b", "a", "c", "a", "d"];
const element = "a";
let idx = array.lastIndexOf(element);
while (idx !== -1) {
  indices.push(idx);
  idx = idx > 0 ? array.lastIndexOf(element, idx - 1) : -1;
}

console.log(indices);
// [4, 2, 0]

Beachten Sie, dass wir hier den Fall idx === 0 separat behandeln müssen, da das Element immer gefunden wird, unabhängig vom fromIndex Parameter, wenn es das erste Element des Arrays ist. Dies unterscheidet sich von der indexOf() Methode.

Sie können lastIndexOf() nicht verwenden, um nach leeren Plätzen in dünn besetzten Arrays zu suchen.

console.log([1, , 3].lastIndexOf(undefined)); // -1

Die lastIndexOf() Methode liest die length Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nichtnegative Ganzzahl kleiner als length ist.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 2,
  3: 5, // ignored by lastIndexOf() since length is 3
};
console.log(Array.prototype.lastIndexOf.call(arrayLike, 2));
// 2
console.log(Array.prototype.lastIndexOf.call(arrayLike, 5));
// -1

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