CKTIS / JavaScript
String.prototype.replaceAll — zamjena svih podudaranja
replaceAll zamjenjuje svako nepoklapajuće podudaranje niza ili globalnog regularnog izraza, a da pritom ne mijenja izvorni niz. Zamjena može biti tekst ili funkcija.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
text.replaceAll(searchValue, replaceValue)Kada je uzorak niz, String.prototype.replaceAll vraća niz u kojem su slijeva nadesno zamijenjena sva nepoklapajuća podudaranja. Ne mijenja izvorni niz i ponovno ne pretražuje umetnuti tekst. Ako nema podudaranja, sadržaj rezultata ostaje nepromijenjen. Za razliku od metode replace s nizom kao uzorkom, ne zaustavlja se nakon prvog podudaranja.
Nizovni searchValue tumači se doslovno: "." znači točku, a ne bilo koji znak. Regularni izraz mora imati zastavicu g; ako je nema, dolazi do pogreške TypeError. Prazan nizovni uzorak podudara se sa svakom granicom UTF-16 kodnih jedinica, uključujući početak i kraj: "ab".replaceAll("", "-") daje "-a-b-". Objekt s metodom [Symbol.replace] može preuzeti operaciju i odrediti njezin rezultat.
replaceValue može biti tekst ili funkcija. U tekstu zamjene $$ označava znak dolara, a $& podudaranje; regularni izrazi podržavaju i reference na grupe za hvatanje. Za doslovno umetanje dinamičkog teksta koji sadrži te nizove upotrijebite () => replacement. Za nizovni uzorak funkcija prima (match, offset, string); za regularni izraz prima i grupe za hvatanje prije pomaka te, ako postoje imenovane grupe, objekt imenovanih grupa na kraju.
Metoda je dio ECMAScripta 2021, a ne Web APIs. Specifikacija nije tablica kompatibilnosti preglednika; činjenica da je Node 24 prisutan u repozitoriju ne dokazuje podršku u pregledniku. Provjerite ciljano okruženje, primjerice pomoću typeof String.prototype.replaceAll === "function".
Primjeri
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Rezultat
a-b-a A.b.A $&.b.$& a.b.a
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.