RegExp.lastMatch ($&)

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Hinweis: Alle RegExp-statischen Eigenschaften, die den letzten Übereinstimmungszustand global offenlegen, sind veraltet. Siehe veraltete RegExp-Funktionen für weitere Informationen.

Die statische Zugriffs-Eigenschaft RegExp.lastMatch gibt die zuletzt übereinstimmende Teilzeichenkette zurück. RegExp["$&"] ist ein Alias für diese Eigenschaft.

Beschreibung

Da lastMatch eine statische Eigenschaft von RegExp ist, verwenden Sie sie immer als RegExp.lastMatch oder RegExp["$&"], und nicht als eine Eigenschaft eines von Ihnen erstellten RegExp-Objekts.

Der Wert von lastMatch wird jedes Mal aktualisiert, wenn eine RegExp-Instanz (aber nicht eine RegExp-Unterklasse) einen erfolgreichen Treffer erzielt. Wenn keine Übereinstimmungen erzielt wurden, ist lastMatch ein leerer String. Der Setter von lastMatch ist undefined, sodass Sie diese Eigenschaft nicht direkt ändern können.

Sie können den Kurzschreibungs-Alias nicht mit dem Punkt-Zugriffsoperator verwenden (RegExp.$&), da & kein gültiges Identifier-Teil ist, sodass dies einen SyntaxError verursacht. Verwenden Sie stattdessen die Klammernotation.

$& kann auch im Ersetzungsstring von String.prototype.replace() verwendet werden, steht aber in keinem Zusammenhang mit der veralteten Eigenschaft RegExp["$&"].

Beispiele

Verwendung von lastMatch und $&

js
const re = /hi/g;
re.test("hi there!");
RegExp.lastMatch; // "hi"
RegExp["$&"]; // "hi"

Spezifikationen

Specification
Legacy RegExp features
# additional-properties-of-the-regexp-constructor

Browser-Kompatibilität

Siehe auch