WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.lastIndexOf — letztes Vorkommen einer Teilzeichenfolge

lastIndexOf() gibt den Index des letzten Vorkommens einer Teilzeichenfolge oder -1 zurück. Das optionale position begrenzt, wo ein Treffer beginnt, nicht, wo er endet.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

str.lastIndexOf(searchString[, position])

String.prototype.lastIndexOf sucht unter Beachtung der Groß- und Kleinschreibung nach einer Teilzeichenfolge und gibt den größten passenden nullbasierten Index oder -1 zurück. Die Methode verändert die Zeichenfolge nicht. Indizes zählen UTF-16-Codeeinheiten, die nicht unbedingt vollständigen, vom Nutzer wahrgenommenen Zeichen entsprechen.

Das optionale position legt den größten zulässigen Startindex eines Treffers fest; der Treffer darf dahinter enden. Wird das Argument ausgelassen oder undefined beziehungsweise NaN übergeben, kann die gesamte Zeichenfolge durchsucht werden. Dezimalwerte werden in Richtung null abgeschnitten, negative Werte auf 0 begrenzt und zu große Werte erweitern die Suche nicht über die Zeichenfolge hinaus. Daher kann ein negatives position weiterhin einen Treffer finden, der bei 0 beginnt.

Eine leere searchString passt an jeder Grenze zwischen Codeeinheiten; ohne position ist das Ergebnis die Länge der Zeichenfolge. searchString wird in eine Zeichenfolge umgewandelt: Wird es ausgelassen, wird nach "undefined" gesucht. Die Methode interpretiert keine regulären Ausdrücke.

Im Beispiel beginnt "ana" an den Indizes 1 und 3. Verwende !== -1, um das Vorhandensein zu prüfen: Index 0 ist ein gültiges Ergebnis, auch wenn er in einer Bedingung als falsy gilt.

Beispiele

const text = "banana";
console.log(text.lastIndexOf("ana"));
console.log(text.lastIndexOf("ana", 2));
console.log(text.lastIndexOf("x"));
console.log(text.lastIndexOf(""));
console.log(text.lastIndexOf("b", -1));

Ergebnis

3
1
-1
6
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen