match()

语法

match(matcher: { [Symbol.match](string: string): RegExpMatchArray | null; }): RegExpMatchArray | null;

描述

用于检索返回一个字符串匹配正则表达式的的结果。

  • 参数是一个正则表达式对象,当传入其他数据类型时会隐式地使用 new RegExp(obj) 将其转换为一个 正则表达式

  • 当正则表达式有i标志时,大小写会被忽略

  • 当正则表达式有`g 标志,将直接返回一个包含所有匹配结果的数组(此时不会返回捕获组),匹配不到时返回null`

  • 当正则表达式没有有g标志,将返回第一个完整匹配,匹配不到时返回null

  • 当正则表达式包含捕获时,会返回所有匹配结果的数组(此时不会返回捕获组),但索引仍然是第一次匹配到的索引

  • 当参数不是是正则表达式时,它会使用 new RegExp(obj)来隐式转换成一个 RegExp。如果它是一个有正号的正数,RegExp() 方法将忽略正号

示例

const str = "yanceyLEO1";
// 当不传入参数时相当于匹配一个空字符串
str.match(); // ['', index: 0, input: 'yanceyLEO1']
// 当有g标志时,直接返回包含所有匹配结果的数组
// 当有i标志时,会忽略大小写
str.match(/[a-e]/gi); // [ 'a', 'c', 'e', 'E' ]
// 当匹配不到时返回 null
str.match(/[f-h]/gi); // null
// 当没有全局标志时,只返回匹配到的第一个结果的捕获组
str.match(/[a-e]/i); // [ 'a', index: 1, input: 'yanceyLEO1' ]
// 当正则不包含捕获时,只返回第一个匹配到结果的捕获组
str.match(/\s*y\s*/); // [ 'y', index: 0, input: 'yanceyLEO1' ]
// 当正则包含捕获时,会返回所有匹配到的结果,但索引仍返回第一次匹配到的索引值
str.match(/(\s*y\s*)/); // [ 'y', 'y', index: 0, input: 'yanceyLEO1' ]
// 当参数是一个字符串或一个数字,它会使用new RegExp(obj)来隐式转换成一个 RegExp。
// 如果它是一个有正号的正数,RegExp() 方法将忽略正号。
str.match("y"); // ['y', index: 0, input: 'yanceyLEO1']
str.match(+1); // ['1', index: 9, input: 'yanceyLEO1']
str.match(-1);
null;

扩展

当正则表达式不包含g标志时,match() 方法将返回与 RegExp.exec() 相同的结果

/[a-e]/i.exec(str); // [ 'a', index: 1, input: 'yanceyLEO1' ]
str.match(/[a-e]/i); // [ 'a', index: 1, input: 'yanceyLEO1' ]

RegExp.test()可以测试一个字符串是否与一个正则表达式匹配,返回一个 Boolean 类型的值

/[a-e]/i.test(str); // true

如果想要获得捕获组,并且设置了全局标志,那么需要使用 RegExp.exec(),此方法只会返回第一个匹配结果

// match()设置了全局将不会返回捕获组
str.match(/[a-e]/ig); // [ 'a', 'c', 'e', 'E' ]
// RegExp.exec()的正则表达式设置了全局,可以返回一个捕获组,且只会返回第一个匹配结果
/[a-e]/ig.exec(str)) // [ 'a', index: 1, input: 'yanceyLEO1' ]
Last updated on by YanceyOfficial