String.prototype.replaceAll()

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

Початковий рядок лишається незміненим.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Синтаксис

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

Параметри

regexp (шаблон)

Об'єкт або літерал регулярного виразу з глобальним прапором. Збіги замінюються на newSubstr або значення, яке повертає вказана функція function. Регулярний вираз без глобального ("g") прапора викине помилку TypeError: "replaceAll must be called with a global RegExp".

substr

Рядок, який потрібно замінити на newSubstr. Він вважається звичайним рядком та не інтерпретується як регулярний вираз.

newSubstr (заміна)

Рядок, який замінює підрядок, вказаний параметром regexp або substr. Підтримується ряд спеціальних шаблонів заміни; дивіться нижче розділ "Використання рядка в якості параметра".

function (заміна)

Функція, що буде викликана для створення нового підрядка, який замінить збіги з наданим параметром regexp або substr. Аргументи, що передаються в цю функцію, описані нижче в розділі "Використання функції в якості параметра".

Значення, що повертається

Новий рядок, в якому усі збіги з шаблоном замінені.

Опис

Цей метод не змінює об'єкт String, що його викликав. Він просто повертає новий рядок.

Використання рядка в якості параметра

Рядок заміни може містити наступні спеціальні шаблони заміни:

Використання функції в якості параметра

Ви можете вказати функцію в якості другого параметра. У цьому випадку функція буде викликана після знайдення збігу. Результат функції (повернене значення) буде використаний в якості рядка заміни. (Заувага: Вищезазначені спеціальні шаблони заміни не застосовуються у цьому випадку.)

Зауважте, що функція буде викликатись багаторазово, для кожного повного збігу, що буде замінений, якщо регулярний вираз у першому параметрі є глобальним.

Функція має наступні аргументи:

(Точна кількість аргументів залежить від того, чи є перший аргумент об'єктом RegExp і, якщо є, то скільки збігів, заключених у дужки, він визначає.)

Приклади

Використання replaceAll

'ааббвв'.replaceAll('б', '.'); 
// 'аа..вв'

Неглобальний регулярний вираз викидає виняток

Якщо використовується регулярний вираз в якості значення пошуку, він повинен бути глобальним. Це не працюватиме:

'ааббвв'.replaceAll(/б/, '.');
TypeError: replaceAll must be called with a global RegExp

Так працюватиме:

'ааббвв'.replaceAll(/б/g, '.');
"аа..вв"

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

Сумісність з веб-переглядачами

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Див. також

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