String.prototype.search()

Probieren Sie es aus

Syntax

Parameter

Ein regulärer Ausdruck oder ein beliebiges Objekt, das eine Symbol.search-Methode hat.

Falls regexp kein RegExp-Objekt ist und keine Symbol.search-Methode besitzt, wird er implizit durch new RegExp(regexp) in einen RegExp umgewandelt.

Rückgabewert

Der Index des ersten Treffers zwischen dem regulären Ausdruck und dem gegebenen String oder -1, wenn kein Treffer gefunden wurde.

Beschreibung

Die Implementierung von String.prototype.search() macht nicht viel, außer die Symbol.search-Methode des Arguments mit dem String als erstem Parameter aufzurufen. Die eigentliche Implementierung stammt von RegExp.prototype[Symbol.search]().

Das g-Flag von regexp hat keinen Einfluss auf das search()-Ergebnis, und die Suche erfolgt immer so, als ob der lastIndex des Regex 0 ist. Für mehr Informationen zum Verhalten von search(), siehe RegExp.prototype[Symbol.search]().

Wenn Sie wissen möchten, ob ein Muster gefunden wird, und auch dessen Index innerhalb eines Strings kennen möchten, verwenden Sie search().

• Wenn Sie nur wissen möchten, ob es existiert, verwenden Sie die RegExp.prototype.test()-Methode, die einen Boolean zurückgibt.
• Wenn Sie den Inhalt des gefundenen Textes benötigen, verwenden Sie String.prototype.match() oder RegExp.prototype.exec().

Beispiele

Verwendung von search()

Das folgende Beispiel durchsucht einen String mit zwei verschiedenen Regex-Objekten, um eine erfolgreiche Suche (positiver Wert) gegenüber einer erfolglosen Suche (-1) zu zeigen.

Spezifikationen

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

• Polyfill von String.prototype.search in core-js mit Fixes und Implementierung von modernem Verhalten wie Symbol.search-Unterstützung
• Leitfaden zu Reguläre Ausdrücke
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype[Symbol.search]()