RegExp.prototype.sticky

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 ab dem Index abzugleichen, der durch die lastIndex-Eigenschaft angegeben wird (und im Gegensatz zu einem globalen Regex, versucht nicht, von späteren Indizes abzugleichen).

Der Set-Zugriff von sticky ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Für sowohl sticky Regex als auch globale Regex:

• Sie beginnen mit dem Abgleich bei lastIndex.
• Wenn der Abgleich erfolgreich ist, wird lastIndex auf das Ende des Abgleichs verschoben.
• Wenn lastIndex außerhalb der Grenzen der derzeit abgeglichenen Zeichenfolge liegt, wird lastIndex auf 0 zurückgesetzt.

Beim exec()-Methode ist das Verhalten bei einem fehlschlagenden Abgleich unterschiedlich:

• Wenn die exec()-Methode bei einem sticky Regex aufgerufen wird und der Regex den Abgleich bei lastIndex nicht schafft, gibt der Regex sofort null zurück und setzt lastIndex auf 0 zurück.
• Wenn die exec()-Methode bei einem globalen Regex aufgerufen wird und der Regex den Abgleich bei lastIndex nicht schafft, versucht es, ab dem nächsten Zeichen abzugleichen, und so weiter, bis ein Abgleich gefunden wird oder das Ende der Zeichenfolge erreicht ist.

Für die exec()-Methode verhält sich ein Regex, das sowohl sticky als auch global ist, wie ein sticky und nicht-globales Regex. Da test() ein einfacher Wrapper um exec() ist, würde test() das globale Flag ignorieren und ebenfalls sticky-Abgleiche durchführen. Aufgrund vieler anderer Methoden, die das Verhalten von globalen Regexen speziell behandeln, ist das globale Flag im Allgemeinen orthogonal zum sticky Flag.

• String.prototype.matchAll() (ruft RegExp.prototype[Symbol.matchAll]() auf): y, g und gy sind alle unterschiedlich.
  • Für y Regex: matchAll() wirft einen Fehler; [Symbol.matchAll]() gibt das exec()-Ergebnis genau einmal zurück, ohne den lastIndex des Regex zu aktualisieren.
  • Für g oder gy Regex: Gibt einen Iterator zurück, der eine Sequenz von exec()-Ergebnissen liefert.
• String.prototype.match() (ruft RegExp.prototype[Symbol.match]() auf): y, g und gy sind alle unterschiedlich.
  • Für y Regex: Gibt das exec()-Ergebnis zurück und aktualisiert den lastIndex des Regex.
  • Für g oder gy Regex: Gibt ein Array aller exec()-Ergebnisse zurück.
• String.prototype.search() (ruft RegExp.prototype[Symbol.search]() auf): das g-Flag ist immer irrelevant.
  • Für y oder gy Regex: Gibt immer 0 zurück (wenn der Anfang der Zeichenfolge übereinstimmt) oder -1 (wenn der Anfang nicht übereinstimmt), ohne den lastIndex des Regex bei Beendigung zu aktualisieren.
  • Für g Regex: Gibt den Index der ersten Übereinstimmung in der Zeichenfolge zurück oder -1, wenn keine Übereinstimmung gefunden wird.
• String.prototype.split() (ruft RegExp.prototype[Symbol.split]() auf): y, g und gy verhalten sich gleich.
• String.prototype.replace() (ruft RegExp.prototype[Symbol.replace]() auf): y, g und gy sind alle unterschiedlich.
  • Für y Regex: Ersetzt einmal am aktuellen lastIndex und aktualisiert lastIndex.
  • Für g und gy Regex: Ersetzt alle Vorkommen, die von exec() abgeglichen werden.
• String.prototype.replaceAll() (ruft RegExp.prototype[Symbol.replace]() auf): y, g und gy sind alle unterschiedlich.
  • Für y Regex: replaceAll() wirft einen Fehler.
  • Für g und gy Regex: Ersetzt alle Vorkommen, die von exec() abgeglichen werden.

Für mehrere Versionen hatte die SpiderMonkey-Engine von Firefox einen Fehler in Bezug auf die ^-Assertion und das sticky-Flag, der es Ausdrücken, die mit der ^-Assertion beginnen und das sticky-Flag verwenden, erlaubte, Übereinstimmungen zu finden, wenn sie es nicht sollten. Der Fehler wurde irgendwann nach Firefox 3.6 eingeführt (welches das sticky-Flag hatte, aber nicht den Fehler) und 2015 behoben. Vielleicht wegen des Fehlers ruft die Spezifikation explizit den Fakt auf:

Auch wenn das y-Flag mit einem Muster verwendet wird, passt ^ immer nur am Anfang von Input oder (wenn rer.[[Multiline]] true ist) am Anfang einer Zeile.

Beispiele für korrektes Verhalten:

const regex = /^foo/y;
regex.lastIndex = 2;
regex.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

• Polyfill des sticky-Flags in core-js
• RegExp.prototype.lastIndex
• RegExp.prototype.dotAll
• RegExp.prototype.global
• RegExp.prototype.hasIndices
• RegExp.prototype.ignoreCase
• RegExp.prototype.multiline
• RegExp.prototype.source
• RegExp.prototype.unicode