RegExp.prototype.global

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

global は RegExp インスタンスのプロパティで、g フラグが正規表現で使われているかどうかを返します。

試してみましょう

const regex1 = /foo/g;

console.log(regex1.global);
// 予想される結果: true

const regex2 = /bar/i;

console.log(regex2.global);
// 予想される結果: false

RegExp.prototype.global は、g フラグが使用された場合は true、そうでない場合は false になります。g フラグは、正規表現が文字列内のすべての可能なマッチに対してテストされるべきであることを示します。 exec() を呼び出すたびに lastIndex プロパティが更新され、次の exec() の呼び出しが次の文字から始まるようになります。

String.prototype.matchAll() や String.prototype.replaceAll() のようないくつかのメソッドは、引数が正規表現である場合、それがグローバルであることを検証します。正規表現の [Symbol.match]() および [Symbol.replace]()（String.prototype.match() と String.prototype.replace() によって呼び出されます）も、正規表現がグローバルである場合に異なる動作をします。

global の設定アクセサーは undefined です。このプロパティを直接変更することはできません。

例

global の使用

const globalRegex = /foo/g;

const str = "fooexamplefoo";
console.log(str.replace(globalRegex, "")); // example

const nonGlobalRegex = /foo/;
console.log(str.replace(nonGlobalRegex, "")); // examplefoo