CKTIS / JavaScript
String.prototype.indexOf — Teilzeichenfolgen finden
String.prototype.indexOf wandelt position um, begrenzt den Wert und sucht ab der so ermittelten Startposition. Die Methode gibt den Index des ersten Vorkommens der Teilzeichenfolge zurück oder -1, wenn es keinen Treffer gibt. Sie unterscheidet zwischen Groß- und Kleinschreibung; Indizes werden in UTF-16-Codeeinheiten gemessen.
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
string.indexOf(searchString)
string.indexOf(searchString, position)String.prototype.indexOf sucht nach einer wörtlichen Teilzeichenfolge, ohne den Text zu verändern. Die Suche beginnt an der Position, die sich durch Umwandlung und Begrenzung von position ergibt. Die Methode gibt den Index des ersten Treffers zurück oder -1, wenn es keinen Treffer gibt. Indizes beginnen bei 0 und geben UTF-16-Codeeinheiten an, nicht unbedingt vollständige sichtbare Zeichen. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.
Das optionale Argument position hat den Standardwert 0. Es wird in eine Ganzzahl umgewandelt, indem der Nachkommateil gegen null abgeschnitten wird, und anschließend auf den Bereich von 0 bis zur Textlänge begrenzt. NaN bedeutet 0. Wenn die Umwandlung von position gelingt, gibt die Methode bei leerem searchString die so ermittelte Position zurück, auch wenn sie am Textende liegt. Wird 0n als position übergeben, löst die Methode noch vor der Suche einen TypeError aus.
searchString wird in eine Zeichenfolge umgewandelt; wenn das Argument fehlt, wird nach "undefined" gesucht. Die Methode interpretiert keine regulären Ausdrücke: Auch ein übergebenes RegExp-Objekt wird in eine Zeichenfolge umgewandelt.
Prüfe, ob die Teilzeichenfolge vorhanden ist, mit result !== -1 und nicht mit if (result): Index 0 ist falsy, während -1 truthy ist. Im Beispiel ändert position, ab wo die Suche beginnt; der zurückgegebene Index bezieht sich jedoch weiterhin auf den gesamten Text.
Beispiele
const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);Ergebnis
1 3 -1 6 true
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.