RegExp 实例的 [Symbol.matchAll] 方法指定了 String.prototype.matchAll 的行为。

{{InteractiveExample("JavaScript Demo: RegExp.prototypeSymbol.matchAll", "taller")}}

```js interactive-example class MyRegExp extends RegExp { Symbol.matchAll { const result = RegExp.prototype[Symbol.matchAll].call(this, str); if (!result) { return null; } return Array.from(result); } }

const re = new MyRegExp("-[0-9]+", "g"); console.log("2016-01-02|2019-03-07".matchAll(re)); // Expected output: Array [Array ["-01"], Array ["-02"], Array ["-03"], Array ["-07"]]


## 语法

```js-nolint
regexp[Symbol.matchAll](str)

参数

  • str
    • : 一个String的匹配对象。

返回值

一个迭代器。

描述

本方法在String.prototype.matchAll()中被内部调用。例如，以下两个示例返回相同的结果。

"abc".matchAll(/a/);

/a/[Symbol.matchAll]("abc");

本方法用于自定义RegExp子类中的匹配行为。

示例

直接调用

本方法的使用方法几乎与 String.prototype.matchAll() 相同，除了 this 的不同以及参数顺序的差异。

var re = /[0-9]+/g;
var str = "2016-01-02";
var result = re[Symbol.matchAll](str);

console.log(Array.from(result, (x) => x[0]));
// ["2016", "01", "02"]

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

RegExp 的子类可以重写 [Symbol.matchAll]() 方法来修改默认行为。例如，返回一个{{jsxref("Array", "数组", "", 1)}}而不是迭代器：

class MyRegExp extends RegExp {
  [Symbol.matchAll](str) {
    var result = RegExp.prototype[Symbol.matchAll].call(this, str);
    if (!result) {
      return null;
    } else {
      return Array.from(result);
    }
  }
}

var re = new MyRegExp("([0-9]+)-([0-9]+)-([0-9]+)", "g");
var str = "2016-01-02|2019-03-07";
var result = str.matchAll(re);
console.log(result[0]); // [ "2016-01-02", "2016", "01", "02" ]
console.log(result[1]); // [ "2019-03-07", "2019", "03", "07" ]

浏览器兼容性

参见

  • {{JSxRef("String.prototype.matchAll()")}}
  • {{JSxRef("Symbol.matchAll")}}