String.prototype.search()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die search() Methode von String Werten führt eine Suche nach einem Treffer zwischen einem regulären Ausdruck und diesem String aus und gibt den Index des ersten Treffers im String zurück.

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 reguläres Ausdrucksobjekt oder ein beliebiges 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.

Rückgabewert

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

Die Implementierung von String.prototype.search() tut nicht viel mehr, als 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 Ergebnis von search(), und die Suche erfolgt immer so, als ob der 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 kennen wollen, verwenden Sie search().

Wenn Sie nur wissen wollen, 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().

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.

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

Specification
ECMAScript® 2026 Language Specification # sec-string.prototype.search