Diese Übersetzung ist unvollständig. Bitte helfen Sie, diesen Artikel aus dem Englischen zu übersetzen.
Die search() methode führt eine Suche für eine Übereinstimmung von einem Regulären Ausdruck und diesem String Objekt.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
str.search(regexp)
Parameter
regexp- Ein Regulär-Ausdruck Objekt. Wenn ein nicht-RegExp Objekt
objeingereicht wird, wird es durchnew RegExp(obj)zuRegExpkonvertiert.
Rückgabewert
Die erste übereinstimmung zwischen dem Regulären Audruck und und der gegebenen Zeichenkette; wenn nicht gefunden, -1.
Beschreibung
Wenn du wissen willst ob ein Muster gefunden wurde, und was sein Index ist nutze search() (wenn du nur wissen willst ob es das gibt nutze die ähnliche test() Methode auf dem RegExp Prototyp, der einen boolean zurückgibt); für mehr informationen (aber langsamererere Ausführung) nutze match() (ähnlich zum Ausdruck exec()).
Beispiele
Benutzung von search()
Das folgende Beispiel durchsucht eine Zeichenkette mit 2 verschiedenen regex Objekten, um eine erfolgreiche, und unerfolgreiche Suche zu zeigen.
var str = "hey JudE"; var re = /[A-Z]/g; var re2 = /[.]/g; console.log(str.search(re)); // gibt 4 zurück, was der Index des ersten Großbuchstaben "J" ist. console.log(str.search(re2)); // gibt -1 zurück kann "." nicht finden
Spezifikationen
| Spezifikation | Status | Kommentar |
|---|---|---|
| ECMAScript 3rd Edition (ECMA-262) | Standard | Initielle Definition. Eingeführt in JavaScript 1.2. |
| ECMAScript 5.1 (ECMA-262) Die Definition von 'String.prototype.search' in dieser Spezifikation. |
Standard | |
| ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'String.prototype.search' in dieser Spezifikation. |
Standard | |
| ECMAScript Latest Draft (ECMA-262) Die Definition von 'String.prototype.search' in dieser Spezifikation. |
Entwurf |
Browser Kompatibilität
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | Server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Grundlegende Unterstützung | Chrome Vollständige Unterstützung Ja | Edge Vollständige Unterstützung Ja | Firefox Vollständige Unterstützung 1 | IE Vollständige Unterstützung Ja | Opera Vollständige Unterstützung Ja | Safari Vollständige Unterstützung Ja | WebView Android Vollständige Unterstützung Ja | Chrome Android Vollständige Unterstützung Ja | Edge Mobile Vollständige Unterstützung Ja | Firefox Android Vollständige Unterstützung 4 | Opera Android Vollständige Unterstützung Ja | Safari iOS Vollständige Unterstützung Ja | Samsung Internet Android Vollständige Unterstützung Ja | nodejs Vollständige Unterstützung Ja |
flags | Chrome Keine Unterstützung Nein | Edge Keine Unterstützung Nein | Firefox Keine Unterstützung 1 — 49 | IE Keine Unterstützung Nein | Opera Keine Unterstützung Nein | Safari Keine Unterstützung Nein | WebView Android Keine Unterstützung Nein | Chrome Android Keine Unterstützung Nein | Edge Mobile Keine Unterstützung Nein | Firefox Android Keine Unterstützung 4 — 49 | Opera Android Keine Unterstützung Nein | Safari iOS Keine Unterstützung Nein | Samsung Internet Android Keine Unterstützung Nein | nodejs Keine Unterstützung Nein |
Legende
- Vollständige Unterstützung
- Vollständige Unterstützung
- Keine Unterstützung
- Keine Unterstützung
- Nicht standardisiert. Erwarte schlechte browserübergreifende Unterstützung.
- Nicht standardisiert. Erwarte schlechte browserübergreifende Unterstützung.
- Veraltet. Nicht für den Einsatz in neuen Webseiten gedacht.
- Veraltet. Nicht für den Einsatz in neuen Webseiten gedacht.
Gecko-spezifische Hinweise
flagswar ein nicht-standard Zweitargument nur in Gecko verfügbar: str.search(regexp, flags)- Vorher Gecko 8.0,
search()war falsch eingeführt; wenn es ohne oder mitundefinedparametern Ausgeführt wurde, würde es mit 'undefined' übereinstimmen, anstatt mit einer leeren Zeichenkette übereinzustimmen. Das wurde behoben; jetzt ist'a'.search()und'a'.search(undefined)korrekt und geben 0 zurück. - Ab Gecko 39 (Firefox 39 / Thunderbird 39 / SeaMonkey 2.36), gibt das nicht-Standard
flagArgument eine Konsolenwarnung (Bug 1142351). - Ab Gecko 47 (Firefox 47 / Thunderbird 47 / SeaMonkey 2.44), ist das nicht-Standard
flagArgument nicht länger unterstützt in nicht-veröffentlichten Builds und wird bald vollständig entfernt (Bug 1245801). - Ab Gecko 49 (Firefox 49 / Thunderbird 49 / SeaMonkey 2.46), ist das nicht-Standard
flagArgument nicht länger unterstützt (Bug 1108382).