База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници