TypeError: String.prototype.replaceAll called with a non-global RegExp argument
Ai dat lui `replaceAll` o expresie regulată fără flagul `g`. `replaceAll` cu regex cere obligatoriu `g`. Adaugă `g` (`/-/g`), folosește `replace` cu `/.../g` sau dă un text simplu: `text.replaceAll("-", "/")`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
replaceAll a fost introdus ca să înlocuiești toate aparițiile unui text fără regex: "a-b-c".replaceAll("-", "/"). Acceptă și expresii regulate, dar numai globale, adică cu flagul g. O regex fără g ar fi contradictorie (înseamnă „doar prima apariție”), așa că motorul aruncă String.prototype.replaceAll called with a non-global RegExp argument.
Aceeași regulă se aplică la matchAll, care are propriul mesaj.
Eroarea e la rulare, pe linia lui replaceAll. Apare des la refactorizare, când cineva înlocuiește replace(/x/g, ...) cu replaceAll(/x/, ...) și scoate g, sau când regex-ul vine dintr-o variabilă creată cu new RegExp(model) fără flaguri.
De ce apare: cauzele frecvente
1Regex fără g
const data = "2026-11-01".replaceAll(/-/, ".");const data = "2026-11-01".replaceAll(/-/g, ".");Cu g, regex-ul e global și replaceAll îl acceptă.
2Regex în loc de text simplu
const slug = titlu.replaceAll(/ /, "-");const slug = titlu.replaceAll(" ", "-");Pentru un caracter fix nu ai nevoie de regex; textul simplu e mai clar și nu are capcana flagului.
3Regex construit dinamic fără flaguri
const rx = new RegExp(cuvant);
text.replaceAll(rx, "***");const rx = new RegExp(cuvant, "gi");
text.replaceAll(rx, "***");Al doilea argument al lui RegExp stabilește flagurile; fără g regex-ul nu e global.
Repară eroarea, direct în pagină
Programul de mai jos transformă un titlu într-un slug pentru URL, dar se oprește cu TypeError: String.prototype.replaceAll called with a non-global RegExp argument. Repară apelul lui replaceAll ca programul să afișeze curs-javascript-pentru-incepatori.
const titlu = "Curs JavaScript pentru incepatori";
const slug = titlu.toLowerCase().replaceAll(/\s+/, "-");
console.log(slug);curs-javascript-pentru-incepatori
Indiciu
O expresie regulată dată lui replaceAll trebuie să aibă flagul g.
Reparația
const titlu = "Curs JavaScript pentru incepatori";
const slug = titlu.toLowerCase().replaceAll(/\s+/g, "-");
console.log(slug);De ce merge
replaceAll înlocuiește toate aparițiile, deci o regex fără g (care înseamnă „doar prima”) e respinsă cu TypeError. Cu /\s+/g, fiecare grup de spații, inclusiv cele trei spații consecutive, devine o singură cratimă. Aici regex-ul e chiar necesar: cu textul simplu " " ai fi obținut trei cratime la rând.
Alte forme ale mesajului
TypeError: replaceAll must be called with a global RegExpTypeError: String.prototype.replaceAll called with a non-global RegExp argument at String.replaceAll
Cum o eviți pe viitor
- Pentru texte fixe folosește
replaceAll("text", "nou"), fără regex. - Când folosești regex cu
replaceAllsaumatchAll, pune întotdeaunag. - La
new RegExp(...)dinamic, trimite flagurile explicit:new RegExp(model, "g").
Întrebări frecvente
De ce replace(/-/, ".") nu dă eroare?
replace acceptă orice regex; fără g înlocuiește doar prima apariție, ceea ce e un comportament valid. Doar replaceAll și matchAll cer g obligatoriu.
Merge replaceAll în toate browserele?
Da, în toate browserele moderne și în Node 15+. În medii foarte vechi lipsește și primești replaceAll is not a function; acolo folosești replace(/x/g, ...).
Erori înrudite
TypeError: String.prototype.matchAll called with a non-global RegExp argument 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)`. SyntaxError: Invalid regular expression flags După bara de final a unei expresii regulate ai o literă care nu e flag valid, de exemplu `/abc/x` sau `/abc/gg`. Flagurile permise sunt `d g i m s u v y`, fiecare o singură dată. Șterge litera în plus sau, dacă e text, pune-l între ghilimele. TypeError: calculeazaTotal is not a function Apelezi cu `()` ceva care nu este o funcție: un număr, un text, un obiect sau `undefined`. De obicei numele metodei e scris greșit, ai suprascris funcția cu o variabilă cu același nume sau metoda nu există pe acel tip de valoare. Verifică ce conține de fapt numele din mesaj. Î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.
