RegExp.leftContext ($`)
Базовый уровень Ограниченная доступность
Эта функция не является Базовым уровнем, потому что она не работает в некоторых из наиболее широко используемых браузеров.
Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она, возможно, уже была удалена из соответствующих веб-стандартов, находится в процессе исключения или сохраняется только в целях совместимости. Избегайте её использования и обновите существующий код, если это возможно; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любой момент.
Примечание: Все RegExp статические свойства, которые глобально раскрывают состояние последнего совпадения, устарели. См. устаревшие функции RegExp для получения дополнительной информации.
Статическое свойство-аксессор RegExp.leftContext возвращает подстроку, предшествующую самому последнему совпадению. RegExp["$`"] является псевдонимом для этого свойства.
Описание
Поскольку leftContext является статическим свойством RegExp, вы всегда используете его как RegExp.leftContext или RegExp["$`"], а не как свойство объекта RegExp, который вы создали.
Значение leftContext обновляется всякий раз, когда экземпляр RegExp (но не подкласса RegExp) находит успешное совпадение. Если совпадений не было, leftContext является пустой строкой. Сет-аксессор leftContext является undefined, поэтому вы не можете изменить это свойство напрямую.
Вы не можете использовать сокращенный псевдоним с точечным аксессором свойства (RegExp.$`), потому что ` не является допустимой частью идентификатора, поэтому это вызывает SyntaxError. Используйте скобочную нотацию вместо этого.
$` также может использоваться в строке замены String.prototype.replace(), но это не связано с устаревшим свойством RegExp["$`"].
Примеры
Использование leftContext и $`
const re = /world/g;
re.test("hello world!");
RegExp.leftContext; // "hello "
RegExp["$`"]; // "hello "
Спецификации
Совместимость с браузерами
| Настольные | Мобильные | Серверные | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | Bun | Deno | Node.js | |
leftContext |
1 |
12 |
1 |
8 |
3 |
18 |
4 |
10.1 |
1 |
1.0 |
4.4 |
1 |
1.0.0 |
1.0 |
0.10.0 |
Смотрите также
RegExp.input($_)RegExp.lastMatch($&)RegExp.lastParen($+)RegExp.rightContext($')RegExp.$1, …,RegExp.$9
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/leftContext
