CKTIS / JavaScript
String.prototype.replace — zamjena teksta
replace() vraća tekst sa zamijenjenim podudaranjima, a da pritom ne mijenja izvornik. Saznajte razliku između pretraživanja nizom i regularnim izrazom te između predložaka za zamjenu i funkcija za zamjenu.
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.replace(searchValue, replaceValue)String.prototype.replace s običnim nizom ili standardnim RegExp vraća novi niz; izvornik ostaje nepromijenjen. Ako nema podudaranja, vraća se nepromijenjeni sadržaj. To je API jezika ECMAScript, a ne API preglednika.
searchValue tipa niz tumači se doslovno i zamjenjuje samo prvo pojavljivanje; prazan niz podudara se na početku. Standardni RegExp bez g zamjenjuje najviše jedno podudaranje; uz g zamjenjuje sva pronađena podudaranja. Objekt s metodom [Symbol.replace] može definirati vlastito ponašanje, uključujući rezultat.
replaceValue tipa niz tumači $$ kao $, $& kao cijelo podudaranje, a $1 kao prvu postojeću uhvaćenu grupu. Funkcija za zamjenu prima podudaranje, zatim uhvaćene grupe, indeks i ulazni niz; ako postoje imenovane grupe, na kraju se dodaje objekt groups. Indeks broji UTF-16 kodne jedinice. Rezultat funkcije pretvara se u niz, ali se nizovi $ ne tumače.
Primjer uspoređuje zamjenu samo prvog podudaranja, globalnu zamjenu, referencu na uhvaćenu grupu i doslovni rezultat funkcije. Ispisom text možete provjeriti i da izvornik ostaje nepromijenjen.
Primjeri
const text = "cat cat";
console.log(text.replace("cat", "dog"));
console.log(text.replace(/cat/g, "dog"));
console.log(text.replace(/(cat)/g, "[$1]"));
console.log(text.replace(/cat/g, () => "$&"));
console.log(text);Rezultat
dog cat dog dog [cat] [cat] $& $& cat cat
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.