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 letzten Übereinstimmungszustand global offenlegen, sind veraltet. Weitere Informationen finden Sie unter veraltete RegExp-Funktionen.
Die statische Accessor-Eigenschaft RegExp.leftContext gibt die Teilzeichenkette zurück, die der letzten Übereinstimmung vorausgeht. RegExp["$`"] ist ein Alias für diese Eigenschaft.
Beschreibung
Da leftContext eine statische Eigenschaft von RegExp ist, verwenden Sie sie immer als RegExp.leftContext oder RegExp["$`"] und nicht als Eigenschaft eines erstellten RegExp-Objekts.
Der Wert von leftContext wird aktualisiert, wann immer eine Instanz von RegExp (aber nicht eine RegExp-Unterklasse) eine erfolgreiche Übereinstimmung findet. Wenn keine Übereinstimmungen gefunden wurden, ist leftContext eine leere Zeichenkette. Der Set-Accessor von leftContext ist undefined, daher können Sie diese Eigenschaft nicht direkt ändern.
Sie können den Kurzschreibalias nicht mit dem Punkt-Eigenschafts-Accessor (RegExp.$` ) verwenden, da ` kein gültiger Bezeichnerteil ist, was zu einem SyntaxError führt. Verwenden Sie stattdessen die Klammernotation.
$` kann auch in der Ersetzungszeichenkette von String.prototype.replace() verwendet werden, aber das ist nicht mit der veralteten Eigenschaft RegExp["$`"] verwandt.
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 |