RegExp.prototype[@@match]()
对正则表达式匹配字符串时,**[@@match]()
**方法用于获取匹配结果。
尝试一下
语法
regexp[Symbol.match](str)
参数
返回值
match 方法会返回一个数组,它包括整个匹配结果,和通过捕获组匹配到的结果,如果没有匹配到则返回 null
描述
这个方法在 String.prototype.match()
的内部调用。例如,下面的两个方法返回相同结果。
js
"abc".match(/a/);
/a/[Symbol.match]("abc");
这个方法为自定义 RegExp
子类中的匹配行为而存在。
示例
直接调用
这个方法的使用方式和 String.prototype.match()
相同,不同之处是 this
和参数顺序。
js
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]()
方法来修改默认行为。
js
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
规范
Specification |
---|
ECMAScript Language Specification # sec-regexp.prototype-@@match |
浏览器兼容性
BCD tables only load in the browser