Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori