JavaScript String replaceAll()

Определение и использование

replaceAll() Метод используется для поиска указанного значения или регулярного выражения в строке.

replaceAll() Метод возвращает новую строку, в которой все соответствия заменены.

replaceAll() Метод не изменяет исходную строку.

replaceAll() Метод был введен в JavaScript 2021.

replaceAll() Метод недоступен в Internet Explorer.

Внимание

Если параметр является регулярным выражением, необходимо установить глобальный флаг (g),в противном случае будет выброшен TypeError。

Более подробную информацию о регулярных выражениях см. здесь:

Урок по регулярным выражениям

Справочник по регулярным выражениям

Пример

Пример 1

text = text.replaceAll("Cats","Dogs");
text = text.replaceAll("cats","dogs");

Попробуйте сами

Пример 2

text = text.replaceAll(/Cats/g,"Dogs");
text = text.replaceAll(/cats/g,"dogs");

Попробуйте сами

Пример 2

Глобальная замена, без учета регистра:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replaceAll(/blue/gi, "red");

Попробуйте сами

Пример 3

Использование функции для замены текста:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replaceAll(/blue|house|car/gi, function (x) {
  return x.toUpperCase();
});

Попробуйте сами

Синтаксис

string.replaceAll(searchValue, newValue)

Параметр

Параметр Описание
searchValue Обязателен. Значение для поиска или регулярное выражение.
newValue Обязателен. Новое значение для замены. Может быть функцией JavaScript.

Возвратное значение

Тип Описание
String Вернуть новую строку, в которой все соответствующие значения заменены.