• 正規表現オブジェクト
  • regexp = new RegExp(patern[, flags])
  • regexp = /pattern/flags
• マッチング
  • regexp.exec(str)
  • str.match(regexp)
  • regexp.test(str)
  • regexp.compile(patern[, flag]) (非推奨)
  • str.matchAll(regexp)
• 正規表現の文法
• フラグ
  • regexp.flags
  • regexp.global
  • regexp.ignoreCase
  • regexp.multiline
  • regexp.unicode
  • regexp.sticky
  • regexp.dotAll
  • regexp.hasIndices
• マッチングの結果
  • regexp.source
  • regexp.lastIndex
  • RegExp.$記号 (非推奨)
  • RegExp.$n (非推奨)
  • RegExp.lastMatch (非推奨)
  • RegExp.leftContext (非推奨)
  • RegExp.rightContext (非推奨)
  • RegExp.lastParen (非推奨)
  • RegExp.input (非推奨)
  • 名前付きキャプチャグループ

正規表現オブジェクトを生成します。正規表現オブジェクトは、文字列のパターンマッチングを行う際に用いられます。次の例は、match() を用いて文字列 str が "DEF" という文字列を含んでいるかどうかを検査します。flags の詳細は フラグ を参照してください。

str = "ABCDEFG";
re = new RegExp("DEF", "ig");
console.log(re.test(str));         // => true

new RegExp() の代わりに、次のように生成することもできます。

str = "ABCDEF";
re = /DEF/ig;
console.log(re.test(str));         // => true

マッチングを行い、マッチした部分文字列（g フラグ指定時は配列）を返します。exec() で str を省略した場合は、RegExp.input で指定された文字列に対してマッチングを行います。

re = /[0-9]+/;
console.log(re.exec("abc123"));         // => 123
console.log("abc123".match(re));        // => 123

マッチングを行い、マッチしたかどうかを真偽値で返します。

re = /[0-9]+/;
console.log(re.test("abc123"));        // => true

高速化のために、正規表現をあらかじめ内部表現形式にコンパイルするのに用いられていました。現在では使用されていません。

re = new RegExp("");
re.compile("[0-9]+");
for (var i = 0; i < 1000; i++) {
  if (str.match(re)) {
    :
  }
}

ES2020 で追加された新しい機能で、文字列 str の中から regexp にマッチするものをリスト(正確にはイテレーター)で返却します。

for (var m of "2020-12-31".matchAll(/[0-9]+/g)) {
  console.log(m);
}
// => ["2020", index: 0, input: "2020-12-31", groups: undefined]
// => ["12", index: 5, input: "2020-12-31", groups: undefined]
// => ["31", index: 8, input: "2020-12-31", groups: undefined]

正規表現では、次のようなマッチング表現を用いることができます。詳細は「とほほの正規表現入門」を参照してください。

バックスラッシュ（\）に続く文字は特別な意味を持ちます。

\p{...} は ES2018(ES9) で追加された機能で、例えばひらがなににマッチする文字は \p{sc=Hiragana} と指定します。

RegExp() の第2引数や /.../ の後ろに記述する i、g、m などのフラグは下記のような意味を持ちます。i と g の両方を指定する時は ig と指定します。

g フラグを指定すると最初にマッチした部分に加え、2番目、3番目...にマッチした部分も配列として返します。

res = "12:34:56".match(/\d+/g);
console.log(res.length);     // => 3
console.log(res[0]);         // => "12"
console.log(res[1]);         // => "34"
console.log(res[2]);         // => "56"

g フラグによるマッチングは、lastIndex 番目以降の文字に対して行われます。下記の様に、ループ処理することも可能です。

var str = "A123 A456 A789";
var re = /A[0-9]+/g;
while (re.exec(str)) {
  console.log(re.lastIndex);         // => 4, 9, 14
  console.log(RegExp.lastMatch);     // => "A123", "A456", "A789"
}

i フラグを指定すると大文字小文字を区別しなくなります。

"abc".match(/ABC/)     // マッチしない
"abc".match(/ABC/i)    // マッチする;

m フラグを指定すると、行頭（^）や行末（$）のマッチングが文字列の先頭・末尾だけではなく、各行の行頭・行末にもマッチするようになります。

"123\n456\n789".match(/^456/)        // マッチしない
"123\n456\n789".match(/^456/m)       // マッチする

u フラグを指定すると、U+10000 以上のサロゲーションペア領域の文字に対しても、1文字とみなすようになります。

"🍔".match(/^.$/)         // 2文字とみなすのでマッチしない
"🍔".match(/^.$/u)        // マッチする

y フラグを指定すると、lastIndex の位置からから先頭マッチングします。

reg = /A/y;
reg.lastIndex = 0; console.log(reg.test("A1A2A3"));        // => true
reg.lastIndex = 1; console.log(reg.test("A1A2A3"));        // => false
reg.lastIndex = 2; console.log(reg.test("A1A2A3"));        // => true

d フラグを指定すると、indices でマッチした文字列の開始・終了インデックスを得ることができるようになります。(ES2022～)

var result = "My name is Yamada".match(/My name is (.*)/d);
console.log(result.indices[0]);  // [0, 17] 文字列全体の開始・終了インデックス
console.log(result.indices[1]);  // [11, 17] 1個目のマッチ文字列の開始・終了インデックス

フラグを示す文字列を返します。

re = /DEF/gi;
console.log(re.flags);       // => "gi"

global は g フラグ、ignoreCase は i フラグ、multiline は m フラグ、unicode は u フラグ、sticky は y フラグ、dotAll は s フラグ、hasIndices は d フラグが指定されているか否かを返します。

re = /DEF/gi;
console.log(re.global);       // => true
console.log(re.ignoreCase);   // => true
console.log(re.multiline);    // => false
console.log(re.unicode);      // => false
console.log(re.sticky);       // => false

RegExp() の第一引数や /.../ で指定したパターン文字列を返します。

reg = /[a-z]+/i;
console.log(reg.source);        // => "[a-z]+"

g フラグが有効な場合に利用可能で、test() や exec() でマッチした部分の次の位置を返します。最初の文字の位置を 0 とします。再度 test() や exec() を行うと、lastIndex の位置を先頭としてマッチングを行います。

var re = /123/g;
var str = 'abc123def';
re.test(str);
console.log(re.lastIndex);   // => 6

RegExp.$記号 の形式は、それぞれ以下の意味を持ちますが、現在では非推奨です。

正規表現内に (...) を指定すると、RegExp.$n で (...) に対応する部分を取り出すことができます。

"12:34:56".match(/(\d+):(\d+):(\d+)/);
console.log(RegExp.$1);   // => 12
console.log(RegExp.$2);   // => 34
console.log(RegExp.$3);   // => 56

直前のマッチングにおいて、lastMatch は最後にマッチした文字列、leftContext はマッチした部分よりも左側の文字列、rightContext は右側の文字列、lastParen は最後の (...) に対応する文字列を返します。lastMatch、leftContext、rightContext、lastParen はそれぞれ、$&、$`、$'、$+ の省略形を用いることもできます。

"abc123def".match(/(123)/);
console.log(RegExp.lastMatch);    // => 123
console.log(RegExp.leftContext);  // => abc
console.log(RegExp.rightContext); // => def
console.log(RegExp.lastParen);    // => 123

最後にマッチした際に、マッチングの対象とした文字列を示します。$_ と同義です。

var re = /123/g;
re.test("abc123def");
console.log(RegExp.input);         // => "abc123def"
re.test("abc456def");              // マッチしないので index は変化しない
console.log(RegExp.input);         // => "abc123def"

ES2018(ES9) で追加された機能で、正規表現のマッチング時に (?<名前>パターン) の様に記述しておくと、マッチングの戻り値の groups.名前 でマッチした文字列を参照できるようになります。

var str = "2019年12月31日";
var result = str.match(/(?<year>\d+)年(?<month>\d+)月(?<day>\d+)日/);
console.log(result.groups.year);      // 2019
console.log(result.groups.month);     // 12
console.log(result.groups.day);       // 31