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 |
包含匹配项的数组。 如果没有找到匹配项,则返回 |
技术细节
参数 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 |
支持 | 支持 | 支持 | 支持 | 支持 | 支持 |