WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.search — Index eines Muster-Treffers finden

Die Methode search() findet den ersten Treffer eines regulären Ausdrucks und gibt dessen Index oder -1 zurück. Ein String als Argument wird als Muster und nicht als wörtlicher Teilstring interpretiert.

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.search(regexp)

String.prototype.search gibt den Index des ersten Treffers eines gewöhnlichen RegExp zurück oder -1, wenn es keinen Treffer gibt. Der Index beginnt bei null und wird in UTF-16-Codeeinheiten gemessen, nicht in sichtbaren Zeichen. Die Methode ändert den String nicht und gibt auch nicht den gefundenen Teilstring zurück. Prüfe das Ergebnis mit !== -1: Der Index 0 steht für einen erfolgreichen Treffer.

Hat das Argument eine aufrufbare [Symbol.search]-Methode, ruft search() sie auf, statt einen neuen regulären Ausdruck zu erstellen. Dabei spielt es keine Rolle, ob die Methode eine eigene oder eine geerbte Eigenschaft ist. Gewöhnliche RegExp-Instanzen erben diese Methode von RegExp.prototype. Ist das Argument null oder undefined oder ergibt der Zugriff auf seine Eigenschaft [Symbol.search] den Wert null oder undefined, erstellt search() aus dem Argument einen regulären Ausdruck. Jeder andere nicht aufrufbare Wert dieser Eigenschaft führt zu einem TypeError. Deshalb gibt "abc".search(".") den Wert 0 zurück: . steht für ein beliebiges Zeichen außer einem Zeilenabschlusszeichen, nicht für einen wörtlichen Punkt. Verwende indexOf() für die Suche nach wörtlichem Text. Wird das Argument weggelassen oder undefined übergeben, entsteht ein leeres Muster und das Ergebnis ist 0.

Bei einem gewöhnlichen RegExp sammelt das Flag g nicht alle Treffer. Die Suche beginnt mit lastIndex auf 0; nach normalem Abschluss wird der vorherige Wert wiederhergestellt. Das Flag y verlangt weiterhin einen Treffer am Anfang des Strings. Die Methode akzeptiert kein Argument für eine Startposition.

Eine benutzerdefinierte [Symbol.search]-Methode kann das Verhalten vollständig festlegen, auch den Ergebnistyp. Im Beispiel beginnen die Ziffern bei Index 7, lastIndex bleibt auf 8, und ein fehlender Treffer ergibt -1.

Beispiele

const text = "Order: 42";
const pattern = /\d+/g;
pattern.lastIndex = 8;

console.log(text.search(pattern));
console.log(pattern.lastIndex);
console.log(text.search(/missing/));
console.log("abc".search("."));

Ergebnis

7
8
-1
0

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