RegExp.$1, …, RegExp.$9

Статические свойства доступа RegExp.$1, …, RegExp.$9 возвращают совпавшие подстроки в скобках.

Описание

Поскольку $1–$9 являются статическими свойствами RegExp, вы всегда используете их как RegExp.$1, RegExp.$2 и т. д., а не как свойства созданного вами объекта RegExp.

Значения $1, …, $9 обновляются всякий раз, когда экземпляр RegExp (но не подкласса RegExp) успешно совпадает. Если совпадений не было или последнее совпадение не имеет соответствующей захватывающей группы, соответствующее свойство будет пустой строкой. Сеттер каждого свойства является undefined, поэтому вы не можете изменять свойства напрямую.

Количество возможных подстрок в скобках неограниченно, но объект RegExp может содержать только первые девять. Вы можете получить доступ ко всем подстрокам в скобках через индексы возвращаемого массива.

$1, …, $9 также можно использовать в строке замены String.prototype.replace(), но это не связано с устаревшими свойствами RegExp.$n.

Примеры

Использование $n с RegExp.prototype.test()

Следующий скрипт использует метод RegExp.prototype.test() для извлечения числа из общей строки.

const str = "Test 24";
const number = /(\d+)/.test(str) ? RegExp.$1 : "0";
number; // "24"

Обратите внимание, что любые операции, связанные с использованием других регулярных выражений между вызовом re.test(str) и свойством RegExp.$n, могут иметь побочные эффекты, поэтому доступ к этим специальным свойствам следует выполнять мгновенно, иначе результат может быть неожиданным.

Спецификации

Совместимость с браузерами

См. также

• RegExp.input ($_)
• RegExp.lastMatch ($&)
• RegExp.lastParen ($+)
• RegExp.leftContext ($`)
• RegExp.rightContext ($')