对正则表达式匹配字符串时,[@@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
规范
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) RegExp.prototype[@@match] |
Standard | 初始定义。 |
ECMAScript Latest Draft (ECMA-262) RegExp.prototype[@@match] |
Draft |
浏览器兼容性
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains.
Find out how you can help!
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | 49 (49) | 未实现 | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 49.0 (49) | 未实现 | (Yes) | (Yes) |