RegExp.prototype.exec()

Метод exec() виконує пошук збігів у заданій стрічці. Він повертає масив або null.

Якщо Ви просто використовуєте регулярний вираз, щоб знайти чи є збіг чи немає використовуйте метод RegExp.prototype.test() або метод String.prototype.search().

Синтаксис

regexObj.exec(str)

Параметри

str

Стрічка яка буде перевірятися на збіг за регулярним виразом.

Що повертає

Якщо збіг є, метод  exec() повертає масив і оновлює властивості об'єкту регулярного виразу. На першій позиції повернутого цим методом масиву буде підстрічка яка задовольняє даний регулярний вираз, на наступних позиціях запам'ятовані збіги за допомогою дужок "()"

Якщо збігів немає, метод exec() повертає null.

Опис

Розглянемо наступний приклад:

// Знайти такий збіг: "Швидка рижа" після чого йде 
// довільна кількість знаків потім слово "стрибає"
// Запам'ятати "рижа" і "стрибає"
// Ігнорувати регістр літер (знайде і рижа і РиЖа)
var re = /швидка\s(рижа).+?(стрибає)/ig;
var result = re.exec('Швидка рижа лисиця стрибає через лінивого пса');

Таблиця підсумовує результати виконання скрипта:

Приклади

Пошук наступних збігів

Якщо регулярний вираз використовує прапорець "g", Ви можете використовувати метод exec() багато разів для того, щоб знайти наступні збіги у стрічці з якою працюєте. Якщо Ви так зробите, пошук почнеться з індексу який  заданий властивістю lastIndex ( метод test() також змінює властивість lastIndex ). Для прикладу, припустимо Ви маєте такий скрипт:

var myRe = /ab*/g;
var str = 'abbcdefabh';
var myArray;
while ((myArray = myRe.exec(str)) !== null) {
  var msg = 'Знайдено ' + myArray[0] + '. ';
  msg += 'Наступний пошук почнеться з індексу ' + myRe.lastIndex;
  console.log(msg);
}

Це скрипт виведе таке:

Знайдено abb. Наступний пошук почнеться з індексу 3
Знайдено ab. Наступний пошук почнеться з індексу 9

Увага: Не створюйте об'єкт (через конструктор RegExp)  або літерал регулярного виразу в умові циклу while оскільки це призведе до нескінченного циклу оскільки властивість lastIndex буде перезаписуватися кожен раз на нуль і метод exec ніколи не поверне null. Також перевірте чи поставили прапорець "g" оскільки його відсутність також призведе до нескінченного циклу.

Використання exec() RegExp літералами

Ви можете використовувати метод exec() без створення об'єкту RegExp:

var matches = /(hello \S+)/.exec('This is a hello world!');
console.log(matches[1]);

Це виведе в консоль повідомлення 'hello world!'

Specifications

Browser compatibility

See also

• Regular Expressions chapter in the JavaScript Guide
• RegExp