Baseline Widely available
Die sticky
Zugriffseigenschaft von RegExp
Instanzen gibt zurück, ob das y
-Flag mit diesem regulären Ausdruck verwendet wird oder nicht.
const str = "table football";
const regex = /foo/y;
regex.lastIndex = 6;
console.log(regex.sticky);
// Expected output: true
console.log(regex.test(str));
// Expected output: true
console.log(regex.test(str));
// Expected output: false
Beschreibung
RegExp.prototype.sticky
hat den Wert true
, wenn das y
-Flag verwendet wurde; andernfalls false
. Das y
-Flag zeigt an, dass der reguläre Ausdruck versucht, die Zielzeichenfolge nur vom durch die lastIndex
Eigenschaft angegebenen Index aus zu matchen (und im Gegensatz zu einem globalen regulären Ausdruck nicht versucht, von späteren Indizes zu matchen).
Der Set-Zugang von sticky
ist undefined
. Sie können diese Eigenschaft nicht direkt ändern.
Für sowohl sticky als auch globale reguläre Ausdrücke gilt:
lastIndex
.lastIndex
zum Ende des Matches vorgerückt.lastIndex
auÃerhalb des Bereichs der aktuell gematchten Zeichenfolge liegt, wird lastIndex
auf 0 zurückgesetzt.Jedoch ist das Verhalten, wenn das Matching fehlschlägt, für die exec()
Methode unterschiedlich:
exec()
Methode auf einem sticky regulären Ausdruck aufgerufen wird und der reguläre Ausdruck beim lastIndex
kein Match findet, gibt der reguläre Ausdruck sofort null
zurück und setzt lastIndex
auf 0 zurück.exec()
Methode auf einem globalen regulären Ausdruck aufgerufen wird und der reguläre Ausdruck beim lastIndex
kein Match findet, versucht sie, vom nächsten Zeichen aus zu matchen, und so weiter, bis ein Match gefunden wird oder das Ende der Zeichenkette erreicht ist.Für die exec()
Methode verhält sich ein regulärer Ausdruck, der sowohl sticky als auch global ist, genauso wie ein sticky und nicht globaler regulärer Ausdruck. Da test()
ein einfacher Wrapper um exec()
ist, würde test()
das globale Flag ignorieren und ebenfalls sticky Matches durchführen. Allerdings ist das globale Flag aufgrund vieler anderer Methoden, die speziell das Verhalten globaler regulärer Ausdrücke behandeln, im Allgemeinen orthogonal zum sticky Flag.
String.prototype.matchAll()
(welches RegExp.prototype[Symbol.matchAll]()
aufruft): y
, g
und gy
sind alle unterschiedlich.
y
-reguläre Ausdrücke: matchAll()
wirft einen Fehler; [Symbol.matchAll]()
gibt das exec()
Ergebnis genau einmal zurück, ohne den lastIndex
des regulären Ausdrucks zu aktualisieren.g
- oder gy
-reguläre Ausdrücke: gibt einen Iterator zurück, der eine Folge von exec()
Ergebnissen liefert.String.prototype.match()
(welches RegExp.prototype[Symbol.match]()
aufruft): y
, g
und gy
sind alle unterschiedlich.
y
-reguläre Ausdrücke: gibt das exec()
Ergebnis zurück und aktualisiert den lastIndex
des regulären Ausdrucks.g
- oder gy
-reguläre Ausdrücke: gibt ein Array aller exec()
Ergebnisse zurück.String.prototype.search()
(welches RegExp.prototype[Symbol.search]()
aufruft): das g
-Flag ist immer irrelevant.
y
- oder gy
-reguläre Ausdrücke: gibt immer 0
(wenn der Anfang der Zeichenkette matcht) oder -1
(wenn der Anfang nicht matcht) zurück, ohne den lastIndex
des regulären Ausdrucks beim Verlassen zu aktualisieren.g
-reguläre Ausdrücke: gibt den Index des ersten Matches in der Zeichenkette oder -1
zurück, wenn kein Match gefunden wird.String.prototype.split()
(welches RegExp.prototype[Symbol.split]()
aufruft): y
, g
und gy
haben alle dasselbe Verhalten.String.prototype.replace()
(welches RegExp.prototype[Symbol.replace]()
aufruft): y
, g
und gy
sind alle unterschiedlich.
y
-reguläre Ausdrücke: ersetzt einmal beim aktuellen lastIndex
und aktualisiert lastIndex
.g
- und gy
-reguläre Ausdrücke: ersetzt alle Vorkommen, die von exec()
gematcht werden.String.prototype.replaceAll()
(welches RegExp.prototype[Symbol.replace]()
aufruft): y
, g
und gy
sind alle unterschiedlich.
y
-reguläre Ausdrücke: replaceAll()
wirft einen Fehler.g
- und gy
-reguläre Ausdrücke: ersetzt alle Vorkommen, die von exec()
gematcht werden.const str = "#foo#";
const 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)
Verankertes sticky Flag
In mehreren Versionen hatte Firefox's SpiderMonkey-Engine einen Fehler in Bezug auf die ^
-Assertion und das sticky Flag, der es ermöglichte, dass Ausdrücke, die mit der ^
-Assertion beginnen und das sticky Flag verwenden, matchen konnten, wenn sie es nicht sollten. Der Fehler wurde einige Zeit nach Firefox 3.6 eingeführt (welches das sticky Flag, aber nicht den Fehler hatte) und 2015 behoben. Vielleicht wegen des Fehlers hebt die Spezifikation ausdrücklich hervor, dass:
Selbst wenn das
y
Flag mit einem Muster verwendet wird, matcht^
immer nur am Anfang von Input, oder (wenn rer.[[Multiline]]true
ist) am Anfang einer Zeile.
Beispiele für korrektes Verhalten:
const regex1 = /^foo/y;
regex1.lastIndex = 2;
regex1.test("..foo"); // false - index 2 is not the beginning of the string
const regex2 = /^foo/my;
regex2.lastIndex = 2;
regex2.test("..foo"); // false - index 2 is not the beginning of the string or line
regex2.lastIndex = 2;
regex2.test(".\nfoo"); // true - index 2 is the beginning of a line
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4