RegExp

RegExp コンストラクタは、パターンに従ったテキストにマッチする正規表現オブジェクトを生成します。

正規表現を詳しく知りたい方は JavaScript ガイド の 正規表現 を参考にしてください。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

リテラル記法およびコンストラクタ記法を使用できます:

/pattern/flags
new RegExp(pattern[, flags])
RegExp(pattern[, flags])

引数

pattern

正規表現のテキスト、または ES5 以降では、その他の RegExp オブジェクト（またはリテラル）（後者は 2 つの RegExp コンストラクターのみ）です。パターンには特殊文字を含めることができるため、文字列リテラルよりも広い範囲の値にマッチすることができます。

flags

flags が指定されると、フラグが追加されるか、パターン用のオブジェクトが供給された場合は flags の値は他のオブジェクトのフラグを置き換えます（そして lastIndex は 0 にリセットされます） (ES2015以降)。flags が指定されず正規表現オブジェクトが供給されない場合、オブジェクトのフラグ(と lastIndex )はコピーされます。この値は次の値を任意の組み合わせで含んだ文字列で指定できます。:

g

グローバルなマッチ。最初のマッチの後に止まることなくすべてのマッチを探す。

i

大文字・小文字の無視。 u フラグが有効の場合、use Unicode case folding

m

複数行に渡るマッチ。先頭および終端を示す文字 (^ や $) が、複数の行で機能します（すなわち、入力文字列全体の先頭および終端だけでなく各々の行 (\n や \r で区切られる) の先頭および末尾にマッチします）。

s

ドットオール。. は改行文字にマッチします。

u

Unicode。パターンを Unicode コードポイントの羅列として扱います。

y

先頭固定 (sticky)。対象文字列中の正規表現の lastIndex プロパティによって示された位置からのみマッチするようになります（それより後の位置からのマッチは試みません）。

説明

RegExp オブジェクトを作成する場合、正規表現リテラルを利用する方法とコンストラクタ関数を利用する方法の 2 通りがあります。正規表現リテラルではスラッシュで囲む代わり、クォートは必要ありません。コンストラクタ関数を利用する場合はスラッシュで囲まない代わりにクォートが必要になります。

以下の例では、同じ正規表現オブジェクトが作成されます。:

/ab+c/i;
new RegExp('ab+c', 'i');
new RegExp(/ab+c/, 'i');

リテラル記法では、正規表現が評価されるときにコンパイルを行います。正規表現が不変である場合に、リテラル記法を使用してください。例えばループ内で使用する正規表現を生成するためにリテラル記法を使用すると、反復処理のたびに正規表現を再コンパイルすることはありません。

new RegExp('ab+c') といった正規表現オブジェクトのコンストラクタは、実行時に正規表現をコンパイルします。正規表現パターンが変わることがわかっている場合や、パターンが不明でありユーザー入力など別のソースからパターンを取得する場合は、コンストラクタ関数を使用してください。

ECMAScript 6 より、第 1 引数が RegExp で第 2 引数に flags を指定する場合 (new RegExp(/ab+c/, 'i')) に TypeError ("can't supply flags when constructing one RegExp from another") が発生しません。代わりに、引数を元に新たな RegExp を生成します。

コンストラクタ関数を使用する場合は、通常の文字エスケープ規則 (文字列内に特殊文字が含まれるとき、前に \ を付加する) が必須です。例えば、以下 2 つの構文は同等です:

var re = /\w+/;
var re = new RegExp('\\w+');

プロパティ

RegExp.prototype

すべてのオブジェクトへプロパティを追加することを許可します。

RegExp.length

RegExp.length の値は 2 です。

get RegExp[@@species]

派生オブジェクトを生成するために使用するコンストラクタ関数です。

RegExp.lastIndex

次のマッチングを開始する位置です。

メソッド

グローバル RegExp オブジェクトは、自分自身のメソッドを持っていませんが、プロトタイプチェーンを通していくつかのメソッドを継承しています。

RegExp プロトタイプオブジェクトとインスタンス

プロパティ

メソッド

例

データフォーマットを変更するための正規表現の使用

以下のスクリプトは、String インスタンスから継承された replace() メソッドを使用して、first last 形式のフォーマットでの名前にマッチさせ、last, first 形式のフォーマットで出力しています。置換テキスト中で、そのスクリプトは、$1 と $2 を使用して、それぞれ対応する正規表現パターンでマッチする括弧がキャプチャした結果を指定しています。

var re = /(\w+)\s(\w+)/;
var str = 'John Smith';
var newstr = str.replace(re, '$2, $1');
console.log(newstr);

これは、"Smith, John" を表示します。

正規表現を使用してさまざまな行末/行の終端/改行で行を分割する

デフォルトの行末は、プラットフォーム (Unix、Windows など) によって異なります。この例で実行する行分割は、あらゆるプラットフォームで動作します。

var text = 'Some text\nAnd some more\r\nAnd yet\rThis is the end';
var lines = text.split(/\r\n|\r|\n/);
console.log(lines); // logs [ 'Some text', 'And some more', 'And yet', 'This is the end' ]

正規表現内のパターンの順序が重要であることに注意してください。

複数行で正規表現を使用する

var s = 'Please yes\nmake my day!';
s.match(/yes.*day/);
// Returns null
s.match(/yes[^]*day/);
// Returns ["yes\nmake my day"]

"sticky" フラグ付きの正規表現の使用

sticky フラグは、対象文字列で RegExp.prototype.lastIndex からマッチングを試みることにより、正規表現の sticky マッチングを実行することを示します。

var str = '#foo#';
var regex = /foo/y;

regex.lastIndex = 1;
regex.test(str); // true
regex.lastIndex = 5;
regex.test(str); // false (lastIndex is taken into account with sticky flag)
regex.lastIndex; // 0 (reset after match failure)

正規表現と Unicode 文字

上の表にもある通り、\w や \W は ASCII 文字にのみマッチします。具体的には 'a' から 'z' 、'A' から 'Z' 、0 から 9 および '_' です。キリル語やヘブライ語で使われるような非 ASCII 文字にマッチさせるには \uhhhh 形式 ('hhhh' の部分は 16進表記の Unicode 値) を使ってください。この例は、文字列全体から Unicode 文字列だけを抜き出す方法をデモしています。

var text = 'Образец text на русском языке';
var regex = /[\u0400-\u04FF]+/g;

var match = regex.exec(text);
console.log(match[0]);        // logs 'Образец'
console.log(regex.lastIndex); // logs '7'

var match2 = regex.exec(text);
console.log(match2[0]);       // logs 'на' [did not log 'text']
console.log(regex.lastIndex); // logs '15'

// and so on

各記述言語ごとの完全な Unicode コードブロック (範囲) を知ることができる外部サイトもあります: Regexp-unicode-block 【訳注: 必要な言語をチェックすると文字クラスを組み立ててくれる便利なサイトです。】

URL からサブドメイン名を抽出する

var url = 'http://xxx.domain.com';
console.log(/[^.]+/.exec(url)[0].substr(7)); // logs 'xxx'

仕様

ブラウザー実装状況

Firefox固有の注意事項

Firefox 34 より、量指定子を伴うキャプチャグループが動作を妨げている場合に、キャプチャグループにマッチしたテキストが空文字列ではなく undefined になります:

// Firefox 33 以前
'x'.replace(/x(.)?/g, function(m, group) {
  console.log("'group:" + group + "'");
}); // 'group:'

// Firefox 34 以降
'x'.replace(/x(.)?/g, function(m, group) {
  console.log("'group:" + group + "'");
}); // 'group:undefined'

web 互換性のため RegExp.$N は引き続き、undefined ではなく空文字列を返します (バグ 1053944)。

関連情報

• JavaScript ガイド内の正規表現の章
• String.prototype.match()
• String.prototype.replace()