test メソッド

文字列内でパターンに一致する部分が存在するかどうかを示すブール値を返します。

rgExp.test(str) 

引数

• rgExp
  必ず指定します。正規表現パターンおよび適用できるフラグを含む Regular Expression オブジェクトのインスタンスです。
• str
  必ず指定します。検索対象となる文字列を指定します。

解説

test メソッドは、文字列内にパターンに一致する部分が存在するかどうかを調べ、存在する場合は真 (true) を、存在しない場合は偽 (false) を返します。

グローバルな RegExp オブジェクトのプロパティは、test メソッドの実行では変更されません。

使用例

次のコードは、test メソッドの使用例です。この例を使用するには、正規表現パターンおよび文字列に関数を渡します。関数は、文字列内に正規表現パターンに一致する部分が存在するかどうかを調べ、検索結果を示す文字列を返します。

function TestDemo(re, s){
   var s1;                         // 変数を宣言します。
   // 正規表現に一致する文字列があるかどうかをテストします。
   if (re.test(s))                 // 有無をテストします。
      s1 = " contains ";           // s には正規表現パターンが含まれています。
   else
      s1 = " does not contain ";   // s には正規表現パターンが含まれていません。
   return("'" + s + "'" + s1 + "'"+ re.source + "'"); // 文字列を返します。
}

必要条件

バージョン 3

参照

RegExp オブジェクト | Regular Expression オブジェクト | Regular Expression Object メソッド | Regular Expression Object プロパティ | 正規表現の構文

対象: Regular Expression オブジェクト