...
Eroare JavaScript · Șiruri, expresii regulate și URI

TypeError: String.prototype.matchAll called with a non-global RegExp argument

Pe scurt

Ai dat lui `matchAll` o expresie regulată fără flagul `g`. `matchAll` parcurge toate potrivirile, deci cere obligatoriu o regex globală. Adaugă `g`: `text.matchAll(/#\w+/g)`.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

matchAll întoarce un iterator cu toate potrivirile unei expresii regulate, fiecare cu grupurile ei și poziția în text. Pentru că scopul lui e să găsească toate aparițiile, o regex fără g ar fi contradictorie, așa că motorul aruncă String.prototype.matchAll called with a non-global RegExp argument.

Dacă îi dai un text în loc de regex, matchAll("abc"), motorul îl transformă automat în new RegExp("abc", "g"), deci nu primești eroarea (dar caracterele speciale din text vor fi interpretate ca regex).

Eroarea apare la rulare, pe linia lui matchAll, chiar și dacă rezultatul nu e parcurs niciodată.

De ce apare: cauzele frecvente

1Regex fără g

Greșit
JavaScript
const postare = "Azi #js și #css";
for (const m of postare.matchAll(/#(\w+)/)) {
  console.log(m[1]);
}
Corect
JavaScript
const postare = "Azi #js și #css";
for (const m of postare.matchAll(/#(\w+)/g)) {
  console.log(m[1]);
}

Cu g, regex-ul e global și matchAll dă câte o potrivire pentru fiecare hashtag.

2Regex refolosit dintr-o variabilă

Greșit
JavaScript
const PRET = /(\d+) lei/;
const toate = [...text.matchAll(PRET)];
Corect
JavaScript
const PRET = /(\d+) lei/g;
const toate = [...text.matchAll(PRET)];

Regex-ul din constantă trebuie declarat global dacă îl folosești cu matchAll.

3Ai nevoie doar de prima potrivire

Greșit
JavaScript
const [prima] = text.matchAll(/(\d+) lei/);
Corect
JavaScript
const prima = text.match(/(\d+) lei/);

Pentru o singură potrivire, match fără g e metoda potrivită și returnează și grupurile.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos extrage toate prețurile dintr-un text și le adună, dar se oprește cu TypeError: String.prototype.matchAll called with a non-global RegExp argument. Repară expresia ca programul să afișeze Prețuri: 25, 40, 15 și Total: 80 lei.

Codul care dă eroarea
JavaScript
const bon = "Cafea 25 lei, prăjitură 40 lei, apă 15 lei";

const preturi = [...bon.matchAll(/(\d+) lei/)].map((m) => Number(m[1]));

console.log(`Prețuri: ${preturi.join(", ")}`);
console.log(`Total: ${preturi.reduce((a, b) => a + b, 0)} lei`);
După reparație, programul afișează
Prețuri: 25, 40, 15
Total: 80 lei
Indiciu

matchAll cere o expresie regulată cu flagul g.

Alte forme ale mesajului

  • TypeError: matchAll must be called with a global RegExp
  • TypeError: String.prototype.matchAll called with a non-global RegExp argument at String.matchAll

Cum o eviți pe viitor

  • Folosește matchAll doar cu /.../g.
  • Pentru prima potrivire folosește match sau exec fără g.
  • Dacă refolosești o regex în mai multe locuri, gândește-te dacă trebuie să fie globală și scrie asta în numele constantei.

Întrebări frecvente

Ce diferență e între match(/x/g) și matchAll(/x/g)?

match cu g întoarce doar textele găsite, fără grupuri și poziții. matchAll întoarce câte un obiect pentru fiecare potrivire, cu grupurile (m[1]), index și grupurile cu nume.

De ce rezultatul lui matchAll nu are length?

E un iterator, nu un tablou. Îl parcurgi cu for...of sau îl transformi în tablou cu [...text.matchAll(rx)] sau Array.from.

Erori înrudite

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.