对正则表达式匹配字符串时，`[@@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!

- Desktop
- Mobile

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)

## 另见

- `String.prototype.match()`
- `RegExp.prototype[@@replace]()`
- `RegExp.prototype[@@search]()`
- `RegExp.prototype[@@split]()`
- `RegExp.prototype.exec()`
- `RegExp.prototype.test()`