Array.prototype.lastIndexOf() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Array.prototype.lastIndexOf()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die lastIndexOf()-Methode von Array-Instanzen gibt den letzten Index zurück, an dem ein bestimmtes Element im Array gefunden werden kann, oder -1, falls es nicht vorhanden ist. Das Array wird rückwärts durchsucht, beginnend bei fromIndex.

In diesem Artikel

Probieren Sie es aus

const animals = ["Dodo", "Tiger", "Penguin", "Dodo"];

console.log(animals.lastIndexOf("Dodo"));
// Expected output: 3

console.log(animals.lastIndexOf("Tiger"));
// Expected output: 1

Syntax

js
lastIndexOf(searchElement)
lastIndexOf(searchElement, fromIndex)

Parameter

searchElement

Element, das im Array gefunden werden soll.

fromIndex Optional

Nullbasierter Index, ab dem rückwärts gesucht wird, in eine ganze Zahl umgewandelt.

Ein negativer Index zählt vom Ende des Arrays zurück — wenn -array.length <= fromIndex < 0, wird fromIndex + array.length verwendet.
Wenn fromIndex < -array.length, wird das Array nicht durchsucht und -1 zurückgegeben. Man kann sich dies konzeptionell so vorstellen, als würde man an einer nicht existierenden 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 weggelassen oder undefined ist, wird array.length - 1 verwendet, wodurch das gesamte Array durchsucht wird. Man kann sich dies konzeptionell so vorstellen, als würde man an einer nicht existierenden Position über dem Ende des Arrays beginnen und von dort rückwärts gehen. Schließlich erreicht es die reale Endposition des Arrays und beginnt dort, rückwärts durch die tatsächlichen Array-Elemente zu suchen.

Rückgabewert

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

Beschreibung

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

Die lastIndexOf()-Methode überspringt leere Plätze in sparsely Arrays.

Die lastIndexOf()-Methode ist generisch. Sie erwartet lediglich, dass der this-Wert eine length-Eigenschaft und ganzzahlige, schlüsselbasierte Eigenschaften hat.

Beispiele

Verwendung von lastIndexOf()

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

js
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.

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

Alle Vorkommen eines Elements finden

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

js
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.

Verwendung von lastIndexOf() in dünn besetzten Arrays

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

Aufrufen von lastIndexOf() bei Nicht-Array-Objekten

Die lastIndexOf()-Methode liest die length-Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel ein nicht-negativer Integer kleiner als length ist.

js
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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Array
Konstruktor
1. Array()
Statische Methoden
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Instanzeigenschaften
1. length
2. [Symbol.unscopables]
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor