RegExp — объект регулярного выражения
Описание
Объект RegExp хранит шаблон регулярного выражения и флаги поиска. Его методы позволяют проверить строку
или получить совпадение и захваченные группы — например, извлечь номер заказа из текста. Здесь описаны создание
объекта, его методы, свойства и состояние между вызовами.
Записи для поиска символов, повторений, групп и границ, а также флаги собраны в справочнике синтаксиса регулярных выражений.
Проверить шаблон на своём тексте можно в тестере регулярных выражений.
Синтаксис
// с помощью специального синтаксиса литералов
const literal = /pattern/flags;
// с помощью конструктора
const fromString = new RegExp("pattern", "flags");
const fromRegExp = new RegExp(existingRegExp, "flags");
Это схема записи: pattern обозначает шаблон, flags — флаги, а
existingRegExp — уже созданный объект RegExp. Переменные literal,
fromString и fromRegExp содержат новые экземпляры.
Значения параметров:
| Параметр | Описание |
|---|---|
pattern |
Строка с шаблоном без внешних косых черт или объект RegExp для копирования. |
flags |
Необязательная строка флагов поиска. При копировании объекта указанные флаги заменяют исходные; если аргумент опущен, сохраняются исходные. Для строкового шаблона без этого аргумента флаги не устанавливаются. |
Литерал удобен для заранее известного шаблона, конструктор — когда шаблон формируется во время выполнения.
В строковом аргументе обратную косую черту удваивают: new RegExp("\\d+", "g") соответствует
/\d+/g. Подробнее —
запись и экранирование шаблона.
Статические методы RegExp
Статические методы вызывают у самого конструктора: RegExp.escape(text).
| Метод | Описание |
|---|---|
RegExp.escape() |
Возвращает строку, безопасную для вставки в шаблон как буквальный текст. Принимает только строковый примитив;
другой тип вызывает TypeError. Это экранирование регулярного выражения, а не HTML или URL.
|
Методы экземпляра RegExp
Методы экземпляра вызывают у созданного выражения, например pattern.test(text), где
pattern — объект RegExp, а text — проверяемая строка.
| Метод | Описание |
|---|---|
exec() |
Возвращает массив первого совпадения с группами, index и input, либо
null. При g или y читает и изменяет lastIndex; при неудаче
сбрасывает его в 0. Пустое совпадение само по себе не продвигает lastIndex.
|
test() |
Возвращает boolean: найдено ли совпадение. Использует exec(), поэтому при g или
y повторные вызовы изменяют lastIndex.
|
toString() |
Возвращает строку вида /source/flags, а не текст совпадения. |
[Symbol.match]() |
Реализует String.prototype.match(): без g возвращает одно совпадение с группами, с
g — массив полных совпадений; при отсутствии совпадений null.
|
[Symbol.matchAll]() |
Возвращает итератор совпадений с группами, работая с копией регулярного выражения. Обычно вызывается через
String.prototype.matchAll().
|
[Symbol.replace]() |
Реализует замену совпадений строкой или результатом функции. Обычно вызывается через
String.prototype.replace() или replaceAll().
|
[Symbol.search]() |
Возвращает индекс первого совпадения или -1. Поиск начинается с 0; исходный
lastIndex восстанавливается.
|
[Symbol.split]() |
Разбивает строку на массив; захватывающие группы разделителя попадают в результат. Обычно вызывается через
String.prototype.split().
|
compile() |
Устарело. Изменяет шаблон и флаги существующего выражения; вместо этого создавайте новый RegExp.
|
Свойства RegExp
Свойства экземпляра читают без скобок: pattern.source, pattern.flags,
pattern.lastIndex. Геттеры, перечисленные как RegExp.prototype.…, доступны через экземпляр.
Свойства самого конструктора, например RegExp.name, указаны отдельно по полному имени.
| Свойство | Описание |
|---|---|
regexp.lastIndex |
Собственное записываемое свойство экземпляра: индекс следующего поиска в кодовых единицах UTF-16. Учитывается
exec()/test() при g или y.
|
RegExp.prototype.source |
Геттер в прототипе: текст шаблона без окружающих / и флагов, с экранированием для строкового представления. |
RegExp.prototype.flags |
Геттер: строка флагов в порядке dgimsuvy. |
RegExp.prototype.global |
Геттер boolean: установлен ли флаг g. |
RegExp.prototype.ignoreCase |
Геттер boolean: установлен ли флаг i. |
RegExp.prototype.multiline |
Геттер boolean: установлен ли флаг m. |
RegExp.prototype.dotAll |
Геттер boolean: установлен ли флаг s. |
RegExp.prototype.unicode |
Геттер boolean: установлен ли флаг u. |
RegExp.prototype.unicodeSets |
Геттер boolean: установлен ли флаг v. |
RegExp.prototype.sticky |
Геттер boolean: установлен ли флаг y. |
RegExp.prototype.hasIndices |
Геттер boolean: установлен ли флаг d; совпадения получают indices.
|
RegExp.prototype.constructor |
Унаследованная ссылка, исходно RegExp. |
RegExp.prototype |
Общий прототип экземпляров регулярных выражений; не путайте с lastIndex конкретного выражения.
|
RegExp[Symbol.species] |
Геттер конструктора, по умолчанию возвращающий this. Используется при создании копий в
протокольных методах matchAll и split.
|
RegExp.length |
Собственное свойство функции-конструктора: число формальных параметров, равное 2. |
RegExp.name |
Собственное имя конструктора: "RegExp". |
Результат поиска
test() подходит, когда нужен только ответ «найдено или нет». Если нужен сам текст совпадения,
вызывайте exec(): элемент 0 результата содержит полное совпадение, элементы
1, 2 и далее — захваченные группы. Свойство index хранит позицию начала,
input — исходную строку, groups — именованные группы, если они есть в шаблоне.
Флаг d добавляет диапазоны indices с исключённой правой границей.
Если совпадения нет, exec() возвращает null: проверяйте результат перед чтением его
элементов. Поиск не изменяет исходную строку, но может изменить
lastIndex выражения.
Для поиска всех совпадений, замены или разбиения строки см.
выбор метода работы со строкой.
Состояние поиска: g, y и lastIndex
Свойство lastIndex хранит позицию следующего поиска в кодовых единицах UTF-16, в том числе с флагами
u и v. У нового выражения оно равно 0; его можно изменить вручную.
Без g и y встроенные методы exec() и test() не учитывают и не меняют
это свойство.
С g метод exec() ищет начиная с lastIndex, с y — строго в этой
позиции. Успех записывает конец совпадения, неудача сбрасывает индекс в 0. Метод test() тоже
меняет это состояние:
const digits = /\d+/g;
console.log(digits.test("123"), digits.lastIndex); // true 3
console.log(digits.test("123"), digits.lastIndex); // false 0
const token = /\d+/y;
token.lastIndex = 1;
console.log(token.exec("a12 b34")[0]); // "12"
console.log(token.lastIndex); // 3
console.log(token.exec("a12 b34")); // null: на позиции 3 пробел
Для независимых проверок через test() обычно берут выражение без g и y. Если
шаблон даёт пустое совпадение, цикл с exec() сам не продвинется вперёд. Для перебора всех совпадений
удобнее matchAll(), который учитывает этот случай.
Устаревшие статические свойства RegExp
| Свойство | Описание |
|---|---|
RegExp.input / RegExp.$_ |
Последняя входная строка. |
RegExp.lastMatch / RegExp.$& |
Последнее полное совпадение. |
RegExp.lastParen / RegExp.$+ |
Последняя захваченная группа. |
RegExp.leftContext / RegExp.$` |
Часть строки до последнего совпадения. |
RegExp.rightContext / RegExp.$' |
Часть строки после последнего совпадения. |
RegExp.$1 |
Устаревшее свойство: содержимое захватывающей группы 1 последнего успешного сопоставления. |
RegExp.$2 |
Устаревшее свойство: содержимое захватывающей группы 2 последнего успешного сопоставления. |
RegExp.$3 |
Устаревшее свойство: содержимое захватывающей группы 3 последнего успешного сопоставления. |
RegExp.$4 |
Устаревшее свойство: содержимое захватывающей группы 4 последнего успешного сопоставления. |
RegExp.$5 |
Устаревшее свойство: содержимое захватывающей группы 5 последнего успешного сопоставления. |
RegExp.$6 |
Устаревшее свойство: содержимое захватывающей группы 6 последнего успешного сопоставления. |
RegExp.$7 |
Устаревшее свойство: содержимое захватывающей группы 7 последнего успешного сопоставления. |
RegExp.$8 |
Устаревшее свойство: содержимое захватывающей группы 8 последнего успешного сопоставления. |
RegExp.$9 |
Устаревшее свойство: содержимое захватывающей группы 9 последнего успешного сопоставления. |
Перечисленные статические свойства последнего совпадения устарели: их общее изменяемое состояние ненадёжно для
передачи результатов между вызовами. Используйте результат exec() или
match().
Общие унаследованные свойства Object и Function здесь не перечислены.
Синтаксис шаблона
Чтобы составить выражение, используйте соответствующий раздел справочника синтаксиса:
- Символы и классы символов.
- Квантификаторы и ленивый поиск.
- Якоря и границы слова.
- Группы и обратные ссылки.
- Проверки соседнего текста.
- Флаги поиска.
- Свойства Юникода и множества с флагом v.
Спецификация
Примеры, попробуйте сами
Как exec() меняет lastIndex
Измените строку или флаг g на y. Наблюдайте позиции совпадений и сброс lastIndex после неудачи.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Как exec() меняет lastIndex</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const text = 'a1 b22'
const pattern = /\d+/g
for (let step = 0; step < 3; step++) {
const match = pattern.exec(text)
console.log(match ? match[0] : null, pattern.lastIndex)
}
console.log(pattern.source, pattern.flags)
console.log(pattern.test(text), pattern.lastIndex)
Именованные группы и индексы
Измените дату или имя группы. Сравните полное совпадение, groups и диапазон indices.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Именованные группы и индексы</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const match = /(?<year>\d{4})-(?<month>\d{2})/d.exec('Дата: 2026-10')
if (match) {
console.log(match[0], match.index)
console.log(match.groups)
console.log(match.indices.groups.year)
} else {
console.log('Совпадения нет')
}
Буквальный поиск пользовательского текста
Замените a+b строкой с точкой или скобками. escape() превращает специальные символы в буквальный шаблон.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Буквальный поиск пользовательского текста</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const input = 'a+b'
if (typeof RegExp.escape === 'function') {
const pattern = new RegExp(RegExp.escape(input), 'g')
console.log('a+b и aaab'.match(pattern))
console.log(pattern.toString())
} else {
console.log('RegExp.escape() не поддерживается в этом браузере')
}