RegExp.leftContext ($`)
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 statischen Eigenschaften von RegExp, die den zuletzt gematchten Zustand global anzeigen, sind veraltet. Siehe veraltete RegExp-Funktionen für weitere Informationen.
Die statische Zugriffs-Eigenschaft RegExp.leftContext gibt die Zeichenfolge zurück, die dem letzten Treffer vorangeht. RegExp["$`"] ist ein Alias für diese Eigenschaft.
Beschreibung
Da leftContext eine statische Eigenschaft von RegExp ist, verwenden Sie es immer als RegExp.leftContext oder RegExp["$`"], anstatt als Eigenschaft eines von Ihnen erstellten RegExp-Objekts.
Der Wert von leftContext wird jedes Mal aktualisiert, wenn eine Instanz von RegExp (aber nicht eine RegExp-Unterklasse) erfolgreich gematcht wird. Wenn keine Übereinstimmungen gefunden wurden, ist leftContext eine leere Zeichenfolge. Der Set-Zugriff von leftContext ist undefined, daher können Sie diese Eigenschaft nicht direkt ändern.
Sie können den Kurzform-Alias nicht mit dem Punktzugriffsoperator verwenden (RegExp.$` ), da ` kein gültiger Identifier-Teil ist, was zu einem SyntaxError führt. Verwenden Sie stattdessen die Klammernotation.
$` kann auch im Ersetzungsstring von String.prototype.replace() verwendet werden, steht aber nicht im Zusammenhang mit der RegExp["$`"]-Alt-Eigenschaft.
Beispiele
Verwendung von leftContext und $`
const re = /world/g;
re.test("hello world!");
RegExp.leftContext; // "hello "
RegExp["$`"]; // "hello "
Spezifikationen
| Specification |
|---|
| Legacy RegExp features # additional-properties-of-the-regexp-constructor |