【Node.js24.x】RegExp::flagsプロパティの使い方
flagsプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
flagsプロパティは、RegExpオブジェクトに設定された正規表現のフラグ（オプション）を文字列として保持するプロパティです。正規表現は、テキストの中から特定のパターンを検索・抽出するために使用されますが、その検索方法には様々なオプション（フラグ）があります。例えば、「g」は文字列全体からすべてのマッチを検索するグローバル検索、「i」は大文字と小文字を区別せず検索するケースインセンシティブ検索、「m」は複数行モードでの検索といった挙動を制御します。
このflagsプロパティは、対象のRegExpインスタンスに設定されているこれらのフラグを、例えば「gim」のように一つの文字列として返します。もしどのフラグも設定されていない正規表現（例: /pattern/）の場合、flagsプロパティは空文字列""を返します。返される文字列内のフラグの順序は、常にアルファベット順にソートされています。これにより、既存の正規表現オブジェクトがどのようなオプションで構成されているかをプログラムで容易に確認し、動的な処理やデバッグに活用することができます。Node.js環境で正規表現を扱う際に、その設定情報を確認するための重要な手段となります。
構文(syntax)
1const regex = /hello/gi; 2console.log(regex.flags); 3 4const anotherRegex = new RegExp("world", "im"); 5console.log(anotherRegex.flags);
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
RegExpオブジェクトに設定されているフラグを文字列として返します。例えば、グローバル検索を表す'g'や大文字小文字を区別しない'i'などが含まれます。