regExp.@@match

regExp.@@match

正则表达式匹配字符串时,[@@match]()方法用于获取匹配结果。

语法

regexp[Symbol.match](str)

参数

strmatch 的目标参数是String

返回值

match 方法会返回一个数组,它包括整个匹配结果,和通过捕获组匹配到的结果,如果没有匹配到则返回null

描述

这个方法在String.prototype.match()的内部调用。例如,下面的两个方法返回相同结果。

'abc'.match(/a/ /a/[Symbol.match]('abc'

这个方法为自定义RegExp子类中的匹配行为而存在。

示例

直接调用

这个方法的使用方式和String.prototype.match()相同,不同之处是this和参数顺序。

var re = /[0-9]+/g; var str = '2016-01-02'; var result = re[Symbol.match](str console.log(result // ["2016", "01", "02"]

在子类中使用@@match

RegExp的子类可以覆写[@@match]()方法来修改默认行为。

class MyRegExp extends RegExp { [Symbol.match](str) { var result = RegExp.prototype[Symbol.match].call(this, str if (!result) return null; return { group(n) { return result[n]; } }; } } var re = new MyRegExp('([0-9]+)-([0-9]+)-([0-9]+)' var str = '2016-01-02'; var result = str.match(re // String.prototype.match calls re[@@match]. console.log(result.group(1) // 2016 console.log(result.group(2) // 01 console.log(result.group(3) // 02

规范

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'RegExp.prototype@@match' in that specification.StandardInitial defintion.
ECMAScript Latest Draft (ECMA-262)The definition of 'RegExp.prototype@@match' in that specification.Draft

浏览器兼容性

FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support(Yes)49 (49)No support(Yes)(Yes)

FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support(Yes)(Yes)49.0 (49)No support(Yes)(Yes)