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 letzten globalen Übereinstimmungszustand anzeigen, sind veraltet. Weitere Informationen finden Sie unter veraltete RegExp-Funktionen.
Die statische Zugriffs-Eigenschaft RegExp.leftContext gibt die Teilzeichenkette zurück, die der zuletzt gefundenen Übereinstimmung vorausgeht. 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["$`"] und nicht als Eigenschaft eines von Ihnen erstellten RegExp-Objekts.
Der Wert von leftContext wird aktualisiert, wann immer eine Instanz von RegExp (aber nicht von einer RegExp-Unterklasse) eine erfolgreiche Übereinstimmung erzielt. Wenn keine Übereinstimmungen gefunden wurden, ist leftContext eine leere Zeichenkette. Der Set-Zugriffszuweiser von leftContext ist undefined, daher können Sie diese Eigenschaft nicht direkt ändern.
Sie können den Kurzalias nicht mit dem Punktzugriffsoperator verwenden (RegExp.$` ), da ` kein gültiger Bezeichnerteil ist, was zu einem SyntaxError führt. Verwenden Sie stattdessen die Klammer-Notation.
$` kann auch in der Ersetzungszeichenkette von String.prototype.replace() verwendet werden, aber das steht nicht im Zusammenhang mit der veralteten Eigenschaft RegExp["$`"].
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 |