JavaScript Ready | Программирование

String.prototype.matchAll — когда нужно работать со всеми совпадениями и группами!

Обычно для поиска по строке используют match или exec, но у них есть ограничения: либо приходится писать цикл с lastIndex, либо поведение с группами зависит от режима работы.

matchAll решает это аккуратно — возвращает итератор по всем совпадениям с доступом к группам, без ручного управления состоянием.

Базовый пример:

const str = "id=1 id=2 id=3";

const matches = str.matchAll(/id=(\d+)/g);

for (const m of matches) {
  console.log(m[1]);
}
// 1 2 3

На выходе — последовательность результатов, аналогичных exec: это массивы с доступом к группам, индексу и исходной строке. Разница в том, что не нужно вручную крутить цикл и следить за lastIndex.

Как ведёт себя match, здесь часто возникает путаница — match работает по-разному в зависимости от флага g:

"id=1".match(/id=(\d+)/);
// ["id=1", "1", ...]

"id=1 id=2".match(/id=(\d+)/g);
// ["id=1", "id=2"]

При глобальном поиске (g) match возвращает только полные совпадения — без capture groups. Это как раз типичный кейс, где matchAll удобнее.

Извлечение структурированных данных:

const str = "x:10 y:20 z:30";

const result = [...str.matchAll(/(\w):(\d+)/g)]
  .map(([, key, val]) => [key, Number(val)]);

console.log(Object.fromEntries(result));
// { x: 10, y: 20, z: 30 }

matchAll позволяет сразу получить пары ключ–значение без ручного управления состоянием регулярки.

Работа с индексами

const str = "test1 test2";

for (const m of str.matchAll(/\w+\d/g)) {
  console.log(m[0], m.index);
}
// test1 0
// test2 6

Каждое совпадение содержит позицию (index), что удобно для парсинга, подсветки, токенизации.

Важно: нужен флаг g

"abc".matchAll(/a/);
// TypeError

Если передать RegExp без g, будет ошибка. Корректно:

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

Также можно передать строку — она будет неявно преобразована в RegExp с флагом g:

[..."abcabc".matchAll("a")];

Именованные группы

const str = "2026-04-19";

for (const m of str.matchAll(
  /(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})/g
)) {
  console.log(m.groups.year);
}

Именованные группы повышают читаемость, особенно при большом количестве групп.

Отличие от exec:

const str = "id=1 id=2 id=3";
const re = /id=(\d+)/g;
let m;

while ((m = re.exec(str))) {
  console.log(m[1]);
}

Подход рабочий, но есть нюансы: мутируется lastIndex, поведение зависит от повторного использования RegExp, легко допустить скрытую ошибку.

🔥

matchAll решает это: он использует внутренний клон регулярки, поэтому не мутирует исходный RegExp и не требует ручного контроля состояния.

📣

JS Ready | #практика

Please open Telegram to view this post