Метод match() строки JavaScript

Определение и использование

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

Совет:Если значением поиска является строка, то она преобразуется в регулярное выражение.

match() Метод возвращает массив, содержащий соответствия.

Если не найдено соответствие, то match() Метод возвращает null.

См. также:

Уроки по регулярным выражениям

Руководство по регулярным выражениям

Разница между String match() и String search()

match() Метод возвращает массив соответствий.

search() Метод возвращает положение первой соответствия.

Пример

Пример 1

Поиск "ain" с использованием строки:

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Попробуйте сами

Пример 2

Поиск "ain" с использованием регулярного выражения:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Попробуйте сами

Пример 3

Глобальный поиск для "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Попробуйте сами

Пример 4

Глобальный, не зависящий от регистра поиск:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Попробуйте сами

Синтаксис

string.match(regexp)

Параметр

Параметр описание
regexp

Обязателен. Значение для поиска.

Регулярное выражение (или строка, которая будет преобразована в регулярное выражение).

Возвратное значение

Тип описание
Массив или null

Массив, содержащий соответствия.

Если не найдено соответствие, то возвращается null.

Технические детали

Параметр regexp

Этот параметр specifies объект RegExp для соответствия шаблону. Если этот параметр не является объектом RegExp, то его передадут в конструктор RegExp(), чтобы преобразовать его в объект RegExp.

Возвратное значение

Массив, хранящий результаты соответствия. Содержимое этого массива зависит от regexp 是否具有全局标志 gимеет ли глобальный признак

. Ниже подробно описывается этот возвращаемый результат.

match() описание stringметод будет искать строку regexp чтобы найти один или несколько соответствий с regexp соответствующий текст. Поведение этого метода в значительной степени зависит от g.

если regexp имеет ли признак match() с признаком g, тогда string метод может выполняться только вmatch() будет выполнен один раз соответствие в null. В противном случае, он вернет массив, содержащий информацию о найденных соответствующих текстах. Первый элемент массива содержит соответствующий текст,其余 элементы содержат тексты, соответствующие подвыражениям регулярного выражения. Кроме этих обычных элементов массива, возвращаемый массив также содержит два объекта свойства. Свойство index declares положение начального символа соответствующего текста в string включая положение, input свойство declares для string включает ссылку на

если regexp с признаком gесли match() метод выполняет глобальный поиск, находит string все соответствующие подстроки в null. Если найдено одно или несколько соответствующих подстрок, то возвращается массив. Однако содержимое массива, возвращенного глобальным соответствием, значительно отличается от предыдущего, его элементы содержат string включая все соответствующие подстроки, и не имеет свойств index или input.

Примечание:в режиме глобального поиска:match() не предоставляет информации о тексте, соответствующем подвыражению, ни о положении каждого соответствующего подстроки. Если вам нужны эти данные глобального поиска, вы можете использовать RegExp.exec().

методы поиска регулярных выражений

В JavaScript текстовый поиск с помощью регулярных выражений можно выполнить различными способами.

Эти методы наиболее часто используются, так как они представляют шаблон в виде регулярного выражения:

пример описание
text.match(pattern) метод match() строки
text.search(pattern) метод search() строки
pattern.exec(text) метод exec() регулярного выражения
pattern.test(text) метод тест() регулярного выражения

поддержка браузерами

match() является функцией ECMAScript1 (ES1).

все браузеры полностью поддерживают ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
поддержка поддержка поддержка поддержка поддержка поддержка

связанные страницы

Строка JavaScript

Методы строки JavaScript

Поиск строки JavaScript