RegExp.prototype[@@match]()
对正则表达式匹配字符串时,[@@match]()
方法用于获取匹配结果。
语法
regexp[Symbol.match](str)
参数
str
- match 的目标参数是
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