JavaScript String match() 方法

定义和用法

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

该参数指定要匹配的模式的 RegExp 对象。如果该参数不是 RegExp 对象,则首先将把它传递给 RegExp() 构造函数,把它转换成 RegExp 对象。

返回值

存放匹配结果的数组。该数组的内容依赖于 regexp 是否具有全局标志 g。下面详细说明了这个返回值。

说明

match() 方法将检索字符串 string,以找到一个或多个与 regexp 匹配的文本。这个方法的行为在很大程度上有赖于 regexp 是否具有标志 g

如果 regexp 没有标志 g,那么 match() 方法就只能在 string 中执行一次匹配。如果没有找到任何匹配的文本,match() 将返回 null。否则,它将返回一个数组,其中存放了与它找到的匹配文本有关的信息。该数组的第 0 个元素存放的是匹配文本,而其余的元素存放的是与正则表达式的子表达式匹配的文本。除了这些常规的数组元素之外,返回的数组还含有两个对象属性。index 属性声明的是匹配文本的起始字符在 string 中的位置,input 属性声明的是对 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) 正则表达式方法 test()

浏览器支持

match() 是 ECMAScript1 (ES1) 特性。

所有浏览器都完全支持 ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

相关页面

JavaScript 字符串

JavaScript 字符串方法

JavaScript 字符串搜索