Метод match () повертає отримані збігу при зіставленні рядки з регулярним виразом.
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. так що регістр букв ігнорується.
Приклад: використання прапорів глобальності і ігнорування регістра з методом match ()
Наступний приклад демонструє використання прапорів глобального пошуку і ігнорування регістра символів разом з методом match (). Повертаються всі букви від А до Д і від а до д, кожна в своєму елементі масиву.