CKTIS / JavaScript
String.prototype.replace — nahrazování textu
replace() vrací text s nahrazenými shodami, aniž by změnila původní text. Poznejte rozdíl mezi hledáním řetězcem a regulárním výrazem a mezi šablonou náhrady a náhradní funkcí.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
text.replace(searchValue, replaceValue)String.prototype.replace s obyčejným řetězcem nebo standardním RegExp vrací nový řetězec; původní zůstává nezměněný. Pokud se nenajde žádná shoda, vrátí se obsah beze změny. Jde o API jazyka ECMAScript, nikoli o API prohlížeče.
Řetězcová hodnota searchValue se chápe doslovně a nahrazuje pouze první výskyt; prázdný řetězec odpovídá začátku. Standardní RegExp bez g nahradí nejvýše jednu shodu; s g nahradí všechny nalezené shody. Objekt s metodou [Symbol.replace] může definovat vlastní chování včetně výsledku.
Řetězcová hodnota replaceValue interpretuje $$ jako $, $& jako celou shodu a $1 jako první existující zachycenou skupinu. Náhradní funkce dostane shodu, potom zachycené skupiny, index a vstupní řetězec; u pojmenovaných skupin dostane navíc na konci objekt groups. Index počítá jednotky kódu UTF-16. Výsledek funkce se převede na řetězec, ale sekvence $ se neinterpretují.
Příklad porovnává nahrazení pouze první shody, globální nahrazení, odkaz na zachycenou skupinu a doslovný výsledek funkce. Výpisem text také ověříte, že původní řetězec zůstává nezměněný.
Příklady
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);Výsledek
dog cat dog dog [cat] [cat] $& $& cat cat
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.