String.prototype.indexOf()

searchString

Der zu suchende Substring. Alle Werte werden in Strings umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass indexOf() nach dem String "undefined" sucht, was selten gewünscht ist.

position Optional

Die Methode gibt den Index des ersten Vorkommens des angegebenen Substrings an einer Position größer oder gleich position zurück, die standardmäßig 0 ist. 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, als wäre position 0.

• 'hello world hello'.indexOf('o', -5) gibt 4 zurück — weil es die Methode dazu bringt, 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 befindet sich an Position 4.

• 'hello world hello'.indexOf('world', 12) gibt -1 zurück — weil, obwohl 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, was dazu führt, dass die Methode den String überhaupt nicht durchsucht.

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

Rückgabewert bei Verwendung eines leeren Suchstrings

Das Suchen nach einem leeren Suchstring 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

Wenn jedoch ein zweites Argument verwendet wird, 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, als hätte sie einen leeren String direkt nach der im zweiten Argument angegebenen Position gefunden. Im letzteren Fall verhält sich die Methode, als hätte sie einen leeren String am Ende des aufrufenden Strings gefunden.

Strings sind null-indexiert: 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 ist case-sensitive. Zum Beispiel gibt der folgende Ausdruck -1 zurück:

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

Wenn überprüft werden soll, ob ein bestimmter Substring in einem String vorkommt, ist der korrekte Weg, 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, außer dass der zweite String Großbuchstaben enthält. Die erste console.log() Methode zeigt 19 an. Aber da die indexOf() Methode case-sensitive ist, 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()