String.prototype.search()

regexp

Ein reguläres Ausdrucksobjekt oder jedes Objekt, das eine Symbol.search-Methode hat.

Wenn regexp kein RegExp-Objekt ist und keine Symbol.search-Methode hat, wird es implizit in ein RegExp umgewandelt, indem new RegExp(regexp) verwendet wird.

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() ist sehr einfach – sie ruft einfach die Symbol.search-Methode des Arguments mit dem String als ersten Parameter auf. Die eigentliche Implementierung stammt von RegExp.prototype[Symbol.search]().

Das g-Flag von regexp hat keinen Effekt auf das search()-Ergebnis, und die Suche erfolgt immer, als ob der lastIndex des Regex 0 wäre. Für weitere Informationen über das Verhalten von search() siehe RegExp.prototype[Symbol.search]().

Wenn Sie wissen möchten, ob ein Muster gefunden wird, und auch den Index innerhalb eines Strings wissen 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().

Das folgende Beispiel durchsucht einen String mit zwei verschiedenen Regex-Objekten, um eine erfolgreiche Suche (positiver Wert) vs. eine erfolglose 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 Fehlerbehebungen und Implementierung des modernen Verhaltens wie Symbol.search Unterstützung
• Leitfaden zu regulären Ausdrücken
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype[Symbol.search]()