CKTIS / JavaScript
String.prototype.replace — zamenjava besedila
replace() vrne besedilo z zamenjanimi ujemanji, ne da bi spremenila izvirnik. Spoznajte razliko med iskanjem z nizi in regularnimi izrazi ter med predlogami za zamenjavo in funkcijami za zamenjavo.
Različica: 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 z navadnim nizom ali standardnim RegExp vrne nov niz; izvirnik ostane nespremenjen. Če ni ujemanja, vrne vsebino brez sprememb. To je API jezika ECMAScript, ne API brskalnika.
Nizovni searchValue se obravnava dobesedno in zamenja samo prvo pojavitev; prazen niz se ujema na začetku. Standardni RegExp brez g zamenja največ eno ujemanje; z g zamenja vsa najdena ujemanja. Objekt z metodo [Symbol.replace] lahko določi lastno vedenje, vključno z rezultatom.
Nizovni replaceValue razume $$ kot $, $& kot celotno ujemanje in $1 kot prvo obstoječo zajeto skupino. Funkcija za zamenjavo prejme ujemanje, nato zajete skupine, indeks in vhodni niz; pri poimenovanih skupinah se na koncu doda objekt groups. Indeks šteje 16-bitne kodne enote UTF-16. Rezultat funkcije se pretvori v niz, vendar se zaporedja $ ne interpretirajo.
Primer primerja zamenjavo samo prvega ujemanja, globalno zamenjavo, sklic na zajeto skupino in dobesedni rezultat funkcije. Izpis text pokaže tudi, da izvirnik ostane nespremenjen.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.