String.prototype.search()

search() メソッドは、対象の String オブジェクトが正規表現で一致するかどうかを調べるためのメソッドです。

構文

str.search(regexp)

引数

regexp
regular expression正規表現オブジェクトです。
正規表現でないオブジェクト regexp が渡された場合は RegExp オブジェクトに new RegExp(regexp) を使用して暗黙的に変換されます。

返値

与えられた文字列と正規表現の間で最初にマッチした箇所のインデックスを返します。マッチしなかった場合は -1 を返します。

解説

あるパターンが見つかるかどうかを知りたい場合、文字列の中の位置を知りたい場合は、 search() メソッドを利用してください。 (存在するかどうかを知りたいだけの場合は、 RegExp に同様のメソッドである test() メソッドがあり、これは論理値を返します。

より多くの情報が欲しい場合は (実行速度が遅くなりますが) match() メソッドを使用してください (同様のメソッドとして、exec() メソッドがあります)。

次の例は、2つの異なる正規表現オブジェクトで文字列を検索し、成功した検索 (正の値) と失敗した検索 (-1) を表示します。

let str = "hey JudE"
let re = /[A-Z]/g
let reDot = /[.]/g
console.log(str.search(re))    // 最初の大文字 "J" の位置である 4 を返します
console.log(str.search(reDot)) // '.' ドット記号が見つからないので -1 を返します

仕様書

仕様書
ECMAScript (ECMA-262)
String.prototype.search の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
searchChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 4Opera 完全対応 4Safari 完全対応 1WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.1.100
flags
非推奨非標準
Chrome 未対応 なしEdge 未対応 なしFirefox 未対応 1 — 49IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしFirefox Android 未対応 4 — 49Opera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。

関連情報