CKTIS / JavaScript
String.prototype.replaceAll — nahrazení všech shod
replaceAll nahrazuje každou nepřekrývající se shodu řetězce nebo globálního regulárního výrazu, aniž by změnila původní řetězec. Náhradou může být text nebo funkce.
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.replaceAll(searchValue, replaceValue)Je-li vzorem řetězec, String.prototype.replaceAll vrátí řetězec, ve kterém jsou zleva doprava nahrazeny všechny nepřekrývající se shody. Původní řetězec nezmění a vložený text znovu neprohledává. Pokud žádná shoda neexistuje, obsah výsledku zůstane stejný. Na rozdíl od replace s řetězcovým vzorem se nezastaví po první shodě.
Řetězcový searchValue se bere doslova: "." znamená tečku, nikoli libovolný znak. Regulární výraz musí mít příznak g; pokud chybí, dojde k chybě TypeError. Prázdný řetězcový vzor odpovídá každé hranici jednotek kódu UTF-16, včetně začátku a konce: "ab".replaceAll("", "-") vytvoří "-a-b-". Objekt s metodou [Symbol.replace] může operaci převzít a určit její výsledek.
replaceValue může být text nebo funkce. V náhradním textu znamená $$ znak dolaru a $& shodu; regulární výrazy podporují také odkazy na zachycené skupiny. Chcete-li doslova vložit dynamický text obsahující tyto sekvence, použijte () => replacement. U řetězcového vzoru funkce dostane (match, offset, string); u regulárního výrazu navíc dostane zachycené skupiny před offsetem a na konci objekt pojmenovaných skupin, pokud existují.
Metoda je součástí ECMAScriptu 2021, nikoli Web APIs. Specifikace není tabulkou kompatibility prohlížečů; přítomnost Node 24 v repozitáři nedokazuje podporu v prohlížeči. Ověřte cílové prostředí, například pomocí typeof String.prototype.replaceAll === "function".
Pří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ýsledek
a-b-a A.b.A $&.b.$& a.b.a
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.