String.prototype.indexOf()

searchString

Substring, nach dem gesucht wird. Alle Werte werden zu Strings konvertiert. Wenn es weggelassen wird oder undefined übergeben wird, sucht indexOf() nach dem String "undefined", was selten erwünscht ist.

position Optional

Die Methode gibt den Index des ersten Vorkommens des angegebenen Substrings an einer Position zurück, die größer oder gleich position ist, standardmäßig 0. Wenn position größer als die Länge des aufrufenden Strings ist, durchsucht die Methode den aufrufenden String überhaupt nicht. Wenn position kleiner als null ist, verhält sich die Methode so, als wäre position 0.

• 'hello world hello'.indexOf('o', -5) gibt 4 zurück — weil es die Methode veranlasst, sich so zu verhalten, als wäre das zweite Argument 0, und das erste Vorkommen von o an einer Position größer oder gleich 0 ist an Position 4.

• 'hello world hello'.indexOf('world', 12) gibt -1 zurück — weil, obwohl es wahr ist, dass der Substring world an Index 6 vorkommt, diese Position nicht größer oder gleich 12 ist.

• 'hello world hello'.indexOf('o', 99) gibt -1 zurück — weil 99 größer als die Länge von hello world hello ist, wodurch die Methode den String überhaupt nicht durchsucht.

Der Index des ersten Vorkommens von searchString, oder -1, wenn nicht gefunden.

Rückgabewert bei Verwendung eines leeren Such-Strings

Die Suche nach einem leeren Such-String liefert seltsame Ergebnisse. Ohne zweites Argument oder mit einem zweiten Argument, dessen Wert kleiner als die Länge des aufgerufenen Strings ist, ist der Rückgabewert derselbe wie der Wert des zweiten Arguments:

"hello world".indexOf(""); // returns 0
"hello world".indexOf("", 0); // returns 0
"hello world".indexOf("", 3); // returns 3
"hello world".indexOf("", 8); // returns 8

Bei einem zweiten Argument, dessen Wert größer oder gleich der Länge des Strings ist, ist der Rückgabewert die Länge des Strings:

"hello world".indexOf("", 11); // returns 11
"hello world".indexOf("", 13); // returns 11
"hello world".indexOf("", 22); // returns 11

Im ersten Fall verhält sich die Methode so, als hätte sie direkt nach der im zweiten Argument angegebenen Position einen leeren String gefunden. Im letzteren Fall verhält sich die Methode so, als hätte sie einen leeren String am Ende des aufrufenden Strings gefunden.

Strings sind nullbasiert indiziert: Der Index des ersten Zeichens eines Strings ist 0, und der Index des letzten Zeichens eines Strings ist die Länge des Strings minus 1.

"Blue Whale".indexOf("Blue"); // returns  0
"Blue Whale".indexOf("Wale"); // returns -1
"Blue Whale".indexOf("Whale", 0); // returns  5
"Blue Whale".indexOf("Whale", 5); // returns  5
"Blue Whale".indexOf("Whale", 7); // returns -1
"Blue Whale".indexOf(""); // returns  0
"Blue Whale".indexOf("", 9); // returns  9
"Blue Whale".indexOf("", 10); // returns 10
"Blue Whale".indexOf("", 11); // returns 10

Die indexOf() Methode unterscheidet Groß- und Kleinschreibung. Zum Beispiel gibt der folgende Ausdruck -1 zurück:

"Blue Whale".indexOf("blue"); // returns -1

Um zu überprüfen, ob ein bestimmter Substring innerhalb eines Strings vorkommt, ist es korrekt zu prüfen, ob der Rückgabewert -1 ist:

"Blue Whale".indexOf("Blue") !== -1; // true; found 'Blue' in 'Blue Whale'
"Blue Whale".indexOf("Wale") !== -1; // false; no 'Wale' in 'Blue Whale'

Das folgende Beispiel verwendet indexOf(), um Substrings im String "Brave new world" zu lokalisieren.

const str = "Brave new world";

console.log(str.indexOf("w")); // 8
console.log(str.indexOf("new")); // 6

Das folgende Beispiel definiert zwei String-Variablen.

Die Variablen enthalten denselben String, mit der Ausnahme, dass der zweite String Großbuchstaben enthält. Die erste console.log() Methode zeigt 19 an. Da die indexOf() Methode jedoch die Groß- und Kleinschreibung unterscheidet, wird der String "cheddar" in myCapString nicht gefunden, sodass die zweite console.log() Methode -1 anzeigt.

const myString = "brie, pepper jack, cheddar";
const myCapString = "Brie, Pepper Jack, Cheddar";

console.log(myString.indexOf("cheddar")); // 19
console.log(myCapString.indexOf("cheddar")); // -1

Das folgende Beispiel setzt count auf die Anzahl der Vorkommen des Buchstabens e im String str:

const str = "To be, or not to be, that is the question.";
let count = 0;
let position = str.indexOf("e");

while (position !== -1) {
  count++;
  position = str.indexOf("e", position + 1);
}

console.log(count); // 4

• String.prototype.charAt()
• String.prototype.lastIndexOf()
• String.prototype.includes()
• String.prototype.split()
• Array.prototype.indexOf()