RegExp.prototype.exec
Ищет совпадение и возвращает подробности: группы и позицию.
Доступно с: ES3
Синтаксис
regex.exec(str)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| str | string | Строка, в которой ищется совпадение. |
Возвращаемое значение
Array | nullМассив с совпадением и группами или null.
Примеры
Совпадение, группы и позиция:
const result = /(\d+)-(\d+)/.exec('Room 12-34');
console.log(result[0], result[1], result[2]);
console.log(result.index);Результат:
12-34 12 34
5Нет совпадения — null:
console.log(/\d+/.exec('no digits'));Результат:
nullПримечания
С флагом g каждый вызов продолжает поиск с позиции lastIndex. Для перебора всех совпадений проще использовать matchAll().
См. также
- String.prototype.match — Ищет совпадения с регулярным выражением.
- String.prototype.matchAll — Возвращает все совпадения вместе с группами.
- Named capture groups — Именованные группы — части совпадения с понятными именами.
В учебнике
- Регулярные выражения — Регулярные выражения в JavaScript для начинающих: шаблоны, флаги, классы символов, проверка, поиск и замена текста.