String.prototype.search()
search()
メソッドは、対象の String
オブジェクトが正規表現で一致するかどうかを調べるためのメソッドです。
試してみましょう
構文
str.search(regexp)
引数
regexp
-
regular expression 正規表現オブジェクトです。
正規表現でないオブジェクト
regexp
が渡された場合はRegExp
オブジェクトにnew RegExp(regexp)
を使用して暗黙的に変換されます。
返値
与えられた文字列と正規表現の間で最初にマッチした箇所のインデックスを返します。マッチしなかった場合は -1
を返します。
解説
例
search() の使用
次の例は、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 を返します
仕様書
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.search |
ブラウザーの互換性
BCD tables only load in the browser