CKTIS / JavaScript
String.prototype.replaceAll — замяна на всички съвпадения
replaceAll заменя всяко неприпокриващо се съвпадение на низ или глобален регулярен израз, без да променя оригиналния низ. Замяната може да бъде текст или функция.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
text.replaceAll(searchValue, replaceValue)Когато шаблонът е низ, String.prototype.replaceAll връща низ, в който всяко неприпокриващо се съвпадение е заменено отляво надясно. Методът не променя оригиналния низ и не търси отново във вмъкнатия текст. Ако няма съвпадения, съдържанието на резултата остава непроменено. За разлика от replace с низов шаблон, методът не спира след първото съвпадение.
Низовият searchValue се интерпретира буквално: "." означава точка, а не произволен знак. Регулярният израз трябва да има флага g; ако той липсва, се хвърля TypeError. Празен низов шаблон съвпада с всяка граница между UTF-16 кодови единици, включително началото и края: "ab".replaceAll("", "-") дава "-a-b-". Обект с метод [Symbol.replace] може да поеме операцията и да определи резултата ѝ.
replaceValue може да бъде текст или функция. В текста за замяна $$ означава знак за долар, а $& означава съвпадението; регулярните изрази поддържат и препратки към групи за улавяне. За да вмъкнете буквално динамичен текст, съдържащ тези последователности, използвайте () => replacement. При низов шаблон функцията получава (match, offset, string); при регулярен израз получава допълнително групите за улавяне преди отместването и, ако има именувани групи, обект с именувани групи накрая.
Методът е част от ECMAScript 2021, а не от Web APIs. Спецификацията не е таблица за съвместимост на браузърите; наличието на Node 24 в хранилище не доказва поддръжка в браузър. Проверете целевата среда, например с typeof String.prototype.replaceAll === "function".
Примери
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Резултат
a-b-a A.b.A $&.b.$& a.b.a
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.