String.prototype.match()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

Сводка

Методmatch() возвращает получившиеся совпадения при сопоставлениистроки срегулярным выражением.

Синтаксис

str.match(regexp)

Параметры

regexp: Объект регулярного выражения. Если будет передан объектobj, не являющийся регулярным выражением, он будет неявно преобразован в объектRegExp через вызов конструктораnew RegExp(obj).

Возвращаемое значение

array: ОбъектArray, содержащий результаты сопоставления, илиnull, если ничего не было сопоставлено.

Если регулярное выражение не содержит флагg, возвращаемый результат будет тем же самым, что и при вызове методаRegExp.exec(). Возвращаемый объектмассива имеет дополнительное свойствоinput, которое содержит оригинальную строку. Кроме того, он имеет свойствоindex, которое представляет индекс (нумерация с нуля) сопоставления в строке.

Если регулярное выражение содержит флагg, метод вернётмассив, содержащий все сопоставления. Если сопоставлений не было, метод вернёт значениеnull.

Смотрите также: методы объекта`RegExp`

Если вам надо просто узнать, подпадает ли строка под регулярное выражение, используйте методsearch().
Если вам нужно найти только первое сопоставление, вы можете использовать методRegExp.exec().

Примеры

Пример: использование метода`match()`

В следующем примере методmatch() используется для поиска слова'Глава', за которым следуют 1 или более цифр, за которыми следуют 0 или более раз группы из точки и цифры. Регулярное выражение включает флагi, так что регистр букв игнорируется.

var str = "Смотри главу 3.4.5.1 для дополнительной информации";var re = /смотри (главу \d+(\.\d)*)/i;var found = str.match(re);console.log(found);// выведет [ 'Смотри главу 3.4.5.1',//           'главу 3.4.5.1',//           '.1',//           index: 0,//           input: 'Смотри главу 3.4.5.1 для дополнительной информации' ]// 'Смотри главу 3.4.5.1' - это полное сопоставление// 'главу 3.4.5.1' - первое значение, сопоставленное с группой "(главу \d+(\.\d)*)".// '.1' - это последнее значение, сопоставленное с группой "(\.\d)".// Свойство 'index' содержит значение (0) индекса совпадения// относительно начала сопоставления// Свойство 'input' содержит значение введённой строки.

Пример: использование флагов глобальности и игнорирования регистра с методом`match()`

Следующий пример демонстрирует использование флагов глобального поиска и игнорирования регистра символов вместе с методомmatch(). Возвращаются все буквы от А до Д и от а до д, каждая в своём элементе массива.

var str = "АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯабвгдеёжзийклмнопрстуфхцчшщьыъэюя";var regexp = /[А-Д]/gi;var matches_array = str.match(regexp);console.log(matches_array);// ['А', 'Б', 'В', 'Г', 'Д', 'а', 'б', 'в', 'г', 'д']