Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje