RegExp 实例的 [Symbol.match]() 方法指定了 String.prototype.match() 的行为。此外，它的存在（或不存在）可能会影响对象是否被视为正则表达式。

{{InteractiveExample("JavaScript Demo: RegExp.prototypeSymbol.match")}}

```js interactive-example class RegExp1 extends RegExp { Symbol.match { const result = RegExp.prototype[Symbol.match].call(this, str); if (result) { return "VALID"; } return "INVALID"; } }

console.log("2012-07-02".match(new RegExp1("([0-9]+)-([0-9]+)-([0-9]+)"))); // Expected output: "VALID"


## 语法

```js-nolint
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"]

在子类中使用 [Symbol.match]()

RegExp 的子类可以覆写 [Symbol.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 调用 re[Symbol.match]()。
console.log(result.group(1)); // 2016
console.log(result.group(2)); // 01
console.log(result.group(3)); // 02