String.prototype.search()

regexp

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

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

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

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

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

Wenn Sie wissen möchten, ob ein Muster gefunden wurde, und auch dessen Index innerhalb eines Strings herausfinden 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 übereinstimmenden Textes benötigen, verwenden Sie String.prototype.match() oder RegExp.prototype.exec().

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.

const str = "hey JudE";
const re = /[A-Z]/;
const reDot = /[.]/;
console.log(str.search(re)); // returns 4, which is the index of the first capital letter "J"
console.log(str.search(reDot)); // returns -1 cannot find '.' dot punctuation

• Polyfill von String.prototype.search in core-js mit Korrekturen und Implementierung des modernen Verhaltens wie Symbol.search-Unterstützung
• Leitfaden für reguläre Ausdrücke
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype[Symbol.search]()