【Node.js24.x】RegExp::test()メソッドの使い方
testメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
testメソッドは、RegExp（正規表現）オブジェクトに定義されており、指定された文字列が正規表現のパターンに一致するかどうかを判定するために利用されるメソッドです。
このメソッドは、引数として検証したい文字列を一つ受け取ります。そして、正規表現パターンがその文字列内に一つでも一致する部分を見つけた場合、trueを返します。もし、文字列内でパターンに一致する部分が一つも見つからなかった場合は、falseを返します。
testメソッドは、文字列中に特定の形式のデータ（例えば、メールアドレスの形式や電話番号の形式など）が含まれているかを素早く確認したい場合や、ユーザーからの入力値が特定の条件を満たしているかをチェックする際などに特に役立ちます。マッチした内容自体を取得する必要がなく、単に一致の有無だけを知りたい場合に非常に効率的です。
注意点として、正規表現にg（global）フラグが設定されている場合、testメソッドを複数回連続して呼び出すと、内部的なlastIndexプロパティが更新されるため、前回のマッチ位置から検索が再開されます。この挙動により、繰り返し呼び出した際の戻り値が交互にtrueとfalseになるなど、予期せぬ結果を生む可能性があるため注意が必要です。単純なパターンマッチの有無を確認する目的であれば、通常はgフラグを付けずに使用するか、毎回新しいRegExpオブジェクトを作成することが推奨されます。
構文(syntax)
1const regex = /pattern/; 2const text = "string to test"; 3console.log(regex.test(text));
引数(parameters)
str
- str: string: 正規表現にマッチするかどうかをテストする対象の文字列
戻り値(return)
boolean
指定された正規表現パターンが、対象の文字列に一致するかどうかを示す真偽値（trueまたはfalse）を返します。