test()メソッドは、正規表現と指定した文字列がマッチするかを調べます。 trueかfalseを返します。

文法

regexObj.test(str)

引数	説明
str	型：string 正規表現のマッチ対象となる文字列を指定します。
戻り値	説明
	型：boolean trueまたはfalseが返ります。

説明

文字列内に正規表現パターンがあるかを知りたい際に、test()を使用することが出来ます。 (String.searchメソッドと似ています。) 更に詳しい情報を取得したければ(ただし動作は遅くなります)、 execメソッドを使用します。 (String.matchメソッドと似ています。) execと一緒に(または組み合わせる事で)、 同じグローバル正規表現インスタンス上で複数回testを呼び出すことで、1つ前のマッチを次に進めます。

サンプル

例: testの使用

下記の例では、testの結果によるメッセージが出力されます。

function testinput(re, str){
    var midstring;
    if (re.test(str)) {
        midstring = " contains ";
    } else {
        midstring = " does not contain ";
    }
    console.log(str + midstring + re.source);
}

仕様

ブラウザの互換性

デスクトップ

機能	Chrome	Firefox (Gecko)	IE	Opera	Safari
基本	◯	◯	◯	◯	◯

モバイル

機能	Android	Chrome for Android	Firefox Mobile	IE Mobile	Opera Mobile	Safari Mobile
基本	◯	◯	◯	◯	◯	◯

関連項目

• JavaScriptガイドの正規表現チャプター
• 正規表現(RegExp)

 Back to top