WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen