String.prototype.indexOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die indexOf()
-Methode von String
-Objekten durchsucht diesen String und gibt den Index des ersten Vorkommens der angegebenen Teilzeichenfolge zurück. Sie akzeptiert eine optionale Startposition und gibt das erste Vorkommen der angegebenen Teilzeichenfolge an einem Index zurück, der größer oder gleich der angegebenen Zahl ist.
Probieren Sie es aus
const paragraph = "I think Ruth's dog is cuter than your dog!";
const searchTerm = "dog";
const indexOfFirst = paragraph.indexOf(searchTerm);
console.log(`The index of the first "${searchTerm}" is ${indexOfFirst}`);
// Expected output: "The index of the first "dog" is 15"
console.log(
`The index of the second "${searchTerm}" is ${paragraph.indexOf(
searchTerm,
indexOfFirst + 1,
)}`,
);
// Expected output: "The index of the second "dog" is 38"
Syntax
indexOf(searchString)
indexOf(searchString, position)
Parameter
searchString
-
Die zu suchende Teilzeichenfolge. Alle Werte werden in Strings umgewandelt, daher führt das Weglassen oder Übergeben von
undefined
dazu, dassindexOf()
nach dem String"undefined"
sucht, was selten gewünscht ist. position
Optional-
Die Methode gibt den Index des ersten Vorkommens der angegebenen Teilzeichenfolge an einer Position größer oder gleich
position
zurück, die standardmäßig auf0
gesetzt ist. Wennposition
größer als die Länge des aufrufenden Strings ist, durchsucht die Methode den String nicht. Wennposition
kleiner als null ist, verhält sich die Methode so, als obposition
gleich0
wäre.-
'hello world hello'.indexOf('o', -5)
gibt4
zurück — weil die Methode sich verhält, als wäre das zweite Argument0
, und das erste Vorkommen vono
an einer Position größer oder gleich0
bei Position4
liegt. -
'hello world hello'.indexOf('world', 12)
gibt-1
zurück — weil, obwohl die Teilzeichenfolgeworld
bei Index6
vorkommt, diese Position nicht größer oder gleich12
ist. -
'hello world hello'.indexOf('o', 99)
gibt-1
zurück — weil99
größer als die Länge vonhello world hello
ist, was dazu führt, dass die Methode den String nicht durchsucht.
-
Rückgabewert
Der Index des ersten Vorkommens von searchString
, oder -1
, wenn nichts gefunden wurde.
Rückgabewert bei Verwendung einer leeren Suchzeichenfolge
Die Suche nach einer leeren Suchzeichenfolge liefert seltsame Ergebnisse. Ohne ein zweites Argument oder mit einem zweiten Argument, dessen Wert kleiner ist als die Länge des aufrufenden Strings, ist der Rückgabewert gleich dem 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
Mit 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 eine leere Zeichenfolge direkt nach der in dem zweiten Argument angegebenen Position gefunden. Im zweiten Fall verhält sich die Methode so, als hätte sie eine leere Zeichenfolge am Ende des aufrufenden Strings gefunden.
Beschreibung
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 ist groß-/kleinschreibungssensitiv. Zum Beispiel liefert der folgende Ausdruck -1
zurück:
"Blue Whale".indexOf("blue"); // returns -1
Überprüfen von Vorkommen
Wenn Sie überprüfen möchten, ob eine bestimmte Teilzeichenfolge in einem String vorkommt, ist die korrekte Methode zu testen, 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'
Beispiele
Verwendung von indexOf()
Das folgende Beispiel verwendet indexOf()
, um Teilzeichenfolgen im String "Brave new world"
zu finden.
const str = "Brave new world";
console.log(str.indexOf("w")); // 8
console.log(str.indexOf("new")); // 6
indexOf() und Groß-/Kleinschreibung
Das folgende Beispiel definiert zwei String-Variablen.
Die Variablen enthalten denselben String, außer dass im zweiten String Großbuchstaben enthalten sind. Die erste console.log()
-Methode zeigt 19
an. Weil jedoch die indexOf()
-Methode groß-/kleinschreibungssensitiv ist, wird der String "cheddar"
nicht in myCapString
gefunden, daher zeigt die zweite console.log()
-Methode -1
an.
const myString = "brie, pepper jack, cheddar";
const myCapString = "Brie, Pepper Jack, Cheddar";
console.log(myString.indexOf("cheddar")); // 19
console.log(myCapString.indexOf("cheddar")); // -1
Verwendung von indexOf(), um Vorkommen eines Buchstabens in einem String zu zählen
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
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-string.prototype.indexof |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
indexOf |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support