МетодreplaceAll() возвращает новую строку со всеми совпадениямиpattern , который меняется наreplacement.pattern может быть строкой или регулярным выражением, иreplacement может быть строкой или функция возвращающая каждое совпадение.

Исходная строка остаётся без изменений.

Интерактивный пример

const paragraph = "I think Ruth's dog is cuter than your dog!";console.log(paragraph.replaceAll("dog", "monkey"));// Expected output: "I think Ruth's monkey is cuter than your monkey!"// Global flag required when calling replaceAll with regexconst regex = /Dog/gi;console.log(paragraph.replaceAll(regex, "ferret"));// Expected output: "I think Ruth's ferret is cuter than your ferret!"

Syntax

const newStr = str.replaceAll(regexp|substr, newSubstr|function)

Parameters

regexp (pattern)

Регулярное выражение или буква с глобальным флагом поиска ("g"). Совпадения меняются наnewSubstr или значении возвращённое указанной функциейfunction. A RegExp без глобального флага поиска ("g") вернёт ошибкуTypeError: "replaceAll must be called with a global RegExp".

substr

Подстрока, которая заменитсяnewSubstr. Обрабатывается как буквенная строка, не интерпретируется как регулярное выражение.

newSubstr (replacement)

Новая строка, которая заменяет найденные подстроки указанные вregexp илиsubstr параметрах. Поддерживается ряд специальных шаблонов замены; смотрите "Specifying a string as a parameter" блок ниже.

function (replacement)

Функция вызванная при создании новой строки которая используется для замены совпадений указанных вregexp orsubstr. Аргументы применяемы в этой функции описываются в "Specifying a function as a parameter" блок ниже.

Return value

Новая строка, в которой все совпадения замены на указанную подстроку или специальный шаблон.

Описание

Этот метод не изменяет исходную строку. Он просто возвращает новую.

Указание строки в качестве параметра

Заменённая строка может включатся в следующие специальные шаблоны:

Указание функции в качестве параметра

Вы можете передать функцию вторым параметром. Этом случае, функция вызывается после нахождения совпадений. Результат функции может быть использована как замещающая строка. (Внимание: Выше упомянутые специальные шаблоны замены в данном случае неприменимы.)

Функция может быть вызвана многократно для каждого заменённого совпадения, если регулярное выражение указано с глобальным флагом("g").

Функция имеет следующие аргументы:

(Точное количество аргументов зависит от того, является ли первый аргумент регулярным выражением — и, если да, то аргументов будет столько сколько указанно в скобках.)

Examples

Using replaceAll

"aabbcc".replaceAll("b", ".");// 'aa..cc'

Non-global regex throws

Поиск с регулярными выражениями должен быть с ("g"). Это не работает:

'aabbcc'.replaceAll(/b/, '.');TypeError: replaceAll must be called with a global RegExp

Это работает:

"aabbcc".replaceAll(/b/g, ".");("aa..cc");

Спецификации

Совместимость с браузерами

Смотрите также

• String.prototype.replace()
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype.test()