String.prototype.search()

Probieren Sie es aus

const paragraph = "I think Ruth's dog is cuter than your dog!";

// Anything not a word character, whitespace or apostrophe
const regex = /[^\w\s']/g;

console.log(paragraph.search(regex));
// Expected output: 41

console.log(paragraph[paragraph.search(regex)]);
// Expected output: "!"

Syntax

search(regexp)

Parameter

regexp

Ein regulrer 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.

Rckgabewert

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

Beschreibung

Die Implementierung von String.prototype.search() macht nicht viel, auer 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. Fr mehr Informationen zum Verhalten von search(), siehe RegExp.prototype[Symbol.search]().

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

• Wenn Sie nur wissen mchten, ob es existiert, verwenden Sie die RegExp.prototype.test()-Methode, die einen Boolean zurckgibt.
• Wenn Sie den Inhalt des gefundenen Textes bentigen, 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) gegenber 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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von String.prototype.search in core-js mit Fixes und Implementierung von modernem Verhalten wie Symbol.search-Untersttzung
• Leitfaden zu Regulre Ausdrcke
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype[Symbol.search]()