Symbol.matchAll

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2020年1月⁩.

Symbol.matchAll は静的データプロパティで、ウェルノウンシンボルである Symbol.matchAll を表します。String.prototype.matchAll() メソッドは最初の引数に対して、文字列に対する現在のオブジェクトの照合を行うイテレーターを返すメソッドを、このシンボルで探します。

詳しくは、RegExp.prototype[Symbol.matchAll]() および String.prototype.matchAll() を参照してください。

試してみましょう

const re = /[0-9]+/g;
const str = "2016-01-02|2019-03-07";
const result = re[Symbol.matchAll](str);

console.log(Array.from(result, (x) => x[0]));
// Expected output: Array ["2016", "01", "02", "2019", "03", "07"]

値

ウェルノウンシンボル Symbol.matchAll です。

`Symbol.matchAll` のプロパティ属性
書込可能	不可
列挙可能	不可
設定可能	不可

例

Symbol.matchAll の使用

const str = "2016-01-02|2019-03-07";

const numbers = {
  *[Symbol.matchAll](str) {
    for (const n of str.matchAll(/[0-9]+/g)) yield n[0];
  },
};

console.log(Array.from(str.matchAll(numbers)));
// ["2016", "01", "02", "2019", "03", "07"]