← 返回首页
String.prototype.replaceAll() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. String
  6. String.prototype.replaceAll()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

String.prototype.replaceAll()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since август 2020 г..

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

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

In this article

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

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 regex const 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)

Примечание: Когда вы используете regexp вы должны установить флаг глобального поиска ("g"), иначе вернётся ошибка TypeError: "replaceAll must be called with a global RegExp".

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 or substr. Аргументы применяемы в этой функции описываются в "Specifying a function as a parameter" блок ниже.

Return value

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

Описание

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

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

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

Pattern Inserts
$$ Вставляет "$".
$& Вставлять совпадения.
$` Вставляет часть строки которая находится перед совпадениями (строка соответствующая шаблону).
$' Вставляет часть строки которая следует после совпадения (строка соответствующая шаблону).
$n Где n положительное цело число меньше чем 100, вставляет nth строки указанные в скобках, частичные совпадения, при условии, что первый аргумент был RegExp object. Обратите внимание, что это 1-индексированный.

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

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

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

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

Possible name Supplied value
match Найденная постройка. (Соответствует $& указанному выше)
p1, p2, ... _n_th количество строк найденных групповыми скобками указанные первым параметром в регулярном выражении. (Соответствует $1, $2, см. выше) Для примера, если /(\a+)(\b+)/, то p1 это \a+, а p2 это \b+.
offset Смещение совпадающей подстроки в пределах всей исследуемой строки. (Например, если вся строка была 'abcd', а соответствующая подстрока была 'bc', то этот аргумент будет равен 1.)
string Исследуется вся цепочка.

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

Examples

Using replaceAll

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

Non-global regex throws

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

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

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

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

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

Specification
ECMAScript® 2027 Language Specification
# sec-string.prototype.replaceall

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

Enable JavaScript to view this browser compatibility table.

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

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 17 февр. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. String
  3. Конструктор
    1. String()
  4. Статические методы
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.raw()
  5. Методы экземпляра
    1. String.prototype.anchor()
    2. at()
    3. String.prototype.big()
    4. String.prototype.blink()
    5. String.prototype.bold()
    6. String.prototype.charAt()
    7. String.prototype.charCodeAt()
    8. String.prototype.codePointAt()
    9. String.prototype.concat()
    10. String.prototype.endsWith()
    11. String.prototype.fixed()
    12. String.prototype.fontcolor()
    13. String.prototype.fontsize()
    14. String.prototype.includes()
    15. String.prototype.indexOf()
    16. isWellFormed()
    17. String.prototype.italics()
    18. String.prototype.lastIndexOf()
    19. String.prototype.link()
    20. String.prototype.localeCompare()
    21. String.prototype.match()
    22. String.prototype.matchAll()
    23. String.prototype.normalize()
    24. String.prototype.padEnd()
    25. String.prototype.padStart()
    26. String.prototype.repeat()
    27. String.prototype.replace()
    28. String.prototype.replaceAll()
    29. String.prototype.search()
    30. String.prototype.slice()
    31. String.prototype.small()
    32. String.prototype.split()
    33. String.prototype.startsWith()
    34. String.prototype.strike()
    35. String.prototype.sub()
    36. String.prototype.substr()
    37. String.prototype.substring()
    38. String.prototype.sup()
    39. String.prototype.toLocaleLowerCase()
    40. String.prototype.toLocaleUpperCase()
    41. String.prototype.toLowerCase()
    42. String.prototype.toString()
    43. String.prototype.toUpperCase()
    44. toWellFormed()
    45. String.prototype.trim()
    46. String.prototype.trimRight()
    47. String.prototype.trimLeft()
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
  6. Свойства экземпляра
    1. String.length
  7. Наследование
  8. Object/Function
  9. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  10. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  11. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.