RegExp.leftContext ($`)
Deprecated
Avoid using this feature in new projects.
The RegExp static properties may have unintended side effects.
This feature may be a candidate for removal from web standards or browsers.
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
| Spezifikation |
|---|
| Legacy RegExp features # additional-properties-of-the-regexp-constructor |