flags1省略可

有効にするフラグの文字列です。i、m、s を任意に組み合わせて含まれています。

flags2省略可

無効にするフラグの文字列です。i、m、s を任意に組み合わせることができますが、flags1 に含まれるフラグは含めることはできません。

pattern

論理和を含む、正規表現リテラルで使用できる何らかの文字で構成されるパターンです。

一部のフラグは、正規表現の構文要素の意味を変更します。

• i フラグは、すべてのリテラル文字および文字クラスを暗黙的に小文字にして、正規表現が大文字と小文字を区別しないようにします。
• m フラグは、入力境界アサーション^ および$ の動作を変更し、入力文字列の開始と終了に加えて、各行の開始と終了にも一致するようにします。
• s フラグは、ワイルドカード文字. の動作を変更し、改行文字を含むすべての文字に一致するようにします。

これらの変更を正規表現パターンの特定の部分でのみ効果にしたい場合があります。その場合は、その部分を修飾子で囲みます。例えば、次のようにします。

/(?i:Hello) world/;

この正規表現では、i フラグはパターンのHello 部分に対してのみ有効です。world 部分は大文字と小文字が区別されます。したがって、Hello world、hello world、HELLO world には一致しますが、HELLO WORLD には一致しません。i フラグをグローバルに有効にして、world 部分に対して無効にすることで、次の式と同等になります。

/Hello (?-i:world)/i;

flags1 およびflags2 引数には、i、m、s を任意に組み合わせて含めることができます。ただし、flags1 とflags2 では、フラグはすべて固有のものである必要があります。つまり、フラグを 2 回有効または無効にしたり、フラグを有効にしてすぐに無効にしたりすることはできません。

引数flags1 およびflags2 はオプションですが、少なくとも 1 つは空ではない必要があります。(?flags1-:pattern) は、フラグのみを有効にする修飾子です（(?flags1:pattern) と同じです）。(?-flags2:pattern) は、フラグのみを無効にする修飾子です。(?:pattern) は単なる非キャプチャグループとなり、(?-:pattern) は構文エラーとなります。

それ以外のフラグはこの修飾子では意味を成さないため、記載すると構文エラーになります。

• g およびy フラグは、exec() の複数回の呼び出しの挙動と、正規表現全体の照合動作への影響を決定します。
• d フラグは、exec() の結果に追加情報を有効にし、正規表現全体の照合動作に影響を与えます。
• u およびv フラグは、正規表現エンジンの動作を、ローカルでは変更できないほど複雑な方法で変更します。また、lastIndex の進め方など、正規表現全体にグローバルな効果をもたらします。

以下の正規表現は、複数行の文字列の書式を定義します。最初の^ は、(?-m:) 修飾子の中に含まれているため、入力文字列全体の先頭を表しますが、それ以外の^ 文字はすべて行の先頭を表します。

const pattern = /(?-m:^)---\n^title:.*^slug:.*^---/ms;const input = `---title: "Modifier: (?ims-ims:...)"slug: Web/JavaScript/Reference/Regular_expressions/Modifier---`;pattern.test(input); // true// 文字列の先頭の余分な改行const input2 = `\n${input}`;pattern.test(input2); // false

foo またはbar という変数宣言をすべて探しているとします（これらは不適切な名前だからです）。この単語は、大文字でも小文字でも現れますが、キーワードは常に小文字であることがわかっているため、次のようにすることができます。

const pattern = /(?:var|let|const) (?i:foo|bar)\b/;pattern.test("let foo;"); // truepattern.test("const BAR = 1;"); // truepattern.test("Let foo be a number"); // false

• グループと後方参照ガイド
• 正規表現
• 非キャプチャグループ:(?:...)