JavaScript RegExp test() メソッド

定義と使用方法

test() テスト文字列の一致項を検出する方法。

一致の項が見つかった場合、それを返します。 true、そうでない場合は、 false。

例

例 1

文字列内で文字"e"を検索します：

let text = "The best things in life are free"; let pattern = /e/;
let result = pattern.test(text);

実際に試してみてください

例2

グローバル検索を行い、文字列内で"Hello"と"W3School"をテストします：

// 文字列：
let text = "Hello world!";
// "Hello"を検索
let pattern1 = /Hello/g;
let result1 = pattern1.test(text);
// "W3School"を検索
let pattern2 = /W3School/g;
let result2 = pattern2.test(text);

実際に試してみてください

構文

regexp.test(string)

パラメータ

パラメータ 説明
string 必須。検索する文字列。

返値

タイプ 説明
Boolean 一致項が見つかった場合、trueを返し、見つからない場合はfalseを返します。

技術的な詳細

返値

文字列が string 中含有する regexp 一致するテキストが含まれている場合、 true、そうでない場合は、 false。

を投げます。

タイプ 説明
TypeError このメソッドを呼び出すオブジェクトがRegExpでない場合、この例外が投げられます。

説明

RegExpオブジェクトの test() メソッドは、文字列が特定のパターンに一致するかどうかを検出します。

test()メソッドは、文字列 string、それが regexp 相匹配するテキストを返します。 string 中含有するテキストがあれば、このメソッドは true、そうでない場合は、 false。

RegExpオブジェクトrのtest()メソッドを呼び出し、それに文字列sを渡すと、以下の表示式と等価です：（r.exec(s) != null）。

ブラウザサポート

test() ECMAScript1（ES1）の機能です。

すべてのブラウザは完全にES1（JavaScript 1997）をサポートしています：

Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート

正規表現検索メソッド

JavaScriptでは、正規表現のテキスト検索は異なる方法で完了できます。

使用パターン（pattern）正規表現として、これらは最もよく使われる方法です：

例 説明
text.match(pattern) 文字メソッド match()
text.search(pattern) 文字メソッド search()
pattern.exec(text) RexExp メソッド exec()
pattern.test(text) RexExp メソッド test()