RegExp.prototype.sticky

sticky プロパティは検索が寛容(sticky)どうかを表します。(この正規表現の lastIndex プロパティによって示されるインデックスからのみの文字列を検索します)。 sticky は正規表現オブジェクトごとの読み取り専用のプロパティです。

説明

sticky の値は Boolean です。"y" フラグが使われていたら、true です。そうでなければ、false です。"y" フラグはターゲット文字列においてこの正規表現の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)

アンカーされた sticky フラグ

この振る舞いは ES2015 で定義され、以前の Firefox 実装と異なります: "パターンとともに y フラグが使用された場合、^ は常に入力の始まりにのみマッチするか、（multiline が true の場合）最初の行にマッチします"。

var regex = /^foo/y;
regex.lastIndex = 2; // disallows to match at the beginning of the string
regex.test("..foo"); // false

var regex2 = /^foo/my;
regex2.lastIndex = 2;
regex2.test("..foo"); // false
regex2.lastIndex = 2;
regex2.test(".\nfoo"); // true

仕様

ブラウザ実装状況

関連情報

• RegExp.lastIndex
• RegExp.prototype.global
• RegExp.prototype.ignoreCase
• RegExp.prototype.multiline
• RegExp.prototype.source