Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri