Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

String.prototype.replace — nahrádzanie textu

replace() vracia text s nahradenými zhodami bez zmeny pôvodného textu. Zistite, aký je rozdiel medzi vyhľadávaním reťazcom a regulárnym výrazom a medzi šablónou náhrady a náhradnou funkciou.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

text.replace(searchValue, replaceValue)

String.prototype.replace s obyčajným reťazcom alebo štandardným RegExp vracia nový reťazec; pôvodný zostáva nezmenený. Ak sa nenájde žiadna zhoda, vráti sa obsah bez zmeny. Ide o API jazyka ECMAScript, nie o API prehliadača.

Reťazcová hodnota searchValue sa chápe doslovne a nahrádza iba prvý výskyt; prázdny reťazec zodpovedá začiatku. Štandardný RegExp bez g nahradí najviac jednu zhodu; s g nahradí všetky nájdené zhody. Objekt s metódou [Symbol.replace] môže určiť vlastné správanie vrátane výsledku.

Reťazcová hodnota replaceValue interpretuje $$ ako $, $& ako celú zhodu a $1 ako prvú existujúcu zachytenú skupinu. Náhradná funkcia dostane zhodu, potom zachytené skupiny, index a vstupný reťazec; pri pomenovaných skupinách dostane na konci navyše objekt groups. Index počíta jednotky kódu UTF-16. Výsledok funkcie sa prevedie na reťazec, ale sekvencie $ sa neinterpretujú.

Príklad porovnáva nahradenie iba prvej zhody, globálne nahradenie, odkaz na zachytenú skupinu a doslovný výsledok funkcie. Výpisom text tiež overíte, že pôvodný reťazec zostáva nezmenený.

Prí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ýsledok

dog cat
dog dog
[cat] [cat]
$& $&
cat cat

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje