CKTIS / JavaScript
String.prototype.replaceAll — nahradenie všetkých zhôd
replaceAll nahrádza každú neprekrývajúcu sa zhodu reťazca alebo globálneho regulárneho výrazu bez zmeny pôvodného reťazca. Náhradou môže byť text alebo funkcia.
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.replaceAll(searchValue, replaceValue)Ak je vzorom reťazec, String.prototype.replaceAll vráti reťazec, v ktorom sa zľava doprava nahradí každá neprekrývajúca sa zhoda. Pôvodný reťazec nezmení a vložený text znova nevyhľadáva. Ak sa nenájde žiadna zhoda, obsah výsledku zostane nezmenený. Na rozdiel od replace s reťazcovým vzorom sa nezastaví po prvej zhode.
Reťazcový searchValue sa interpretuje doslovne: "." znamená bodku, nie ľubovoľný znak. Regulárny výraz musí mať príznak g; ak chýba, vyvolá sa TypeError. Prázdny reťazcový vzor zodpovedá každej hranici jednotiek kódu UTF-16 vrátane začiatku a konca: "ab".replaceAll("", "-") vytvorí "-a-b-". Objekt s metódou [Symbol.replace] môže operáciu prevziať a určiť jej výsledok.
replaceValue môže byť text alebo funkcia. V náhradnom texte znamená $$ znak dolára a $& zhodu; regulárne výrazy podporujú aj odkazy na zachytávacie skupiny. Ak chcete doslovne vložiť dynamický text obsahujúci tieto sekvencie, použite () => replacement. Pri reťazcovom vzore funkcia dostane (match, offset, string); pri regulárnom výraze dostane navyše zachytávacie skupiny pred offsetom a na konci objekt pomenovaných skupín, ak také skupiny existujú.
Metóda patrí do ECMAScriptu 2021, nie do Web APIs. Špecifikácia nie je tabuľkou kompatibility prehliadačov; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači. Skontrolujte cieľové prostredie, napríklad pomocou typeof String.prototype.replaceAll === "function".
Príklady
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Výsledok
a-b-a A.b.A $&.b.$& a.b.a
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.