← 返回首页
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. Tecnologia Web para desenvolvedores
  2. JavaScript
  3. Referência JavaScript
  4. Objetos Globais
  5. String
  6. String.prototype.replaceAll()
Theme
  • OS default
  • Light
  • Dark
Português (do Brasil)
Remember language Learn more

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

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 agosto de 2020.

O método replaceAll() retorna uma nova string com todas as ocorrências de um padrão substituídas por uma substituição. O padrão pode ser uma string ou uma RegExp, e a substituição pode ser uma string ou uma função a ser chamada para cada ocorrência.

A string original é mantida sem modificação.

In this article

Experimente

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!"

Sintaxe

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

Nota: Quando usar uma regexp, você deve colocar o sinalizador (flag) global "g". Do contrário, será retornado um TypeError: "replaceAll must be called with a global RegExp".

Parâmetros

regexp (padrão)

Uma RegExp ou literal com o sinalizador (flag) global. As ocorrências serão substituídas por newSubstr ou pelo valor retornado da function (função) especificada.

substr (padrão)

Uma String que deve ser substituída por newSubstr. É tratada como uma string literal e não é interpretada como uma expressão regular (RegExp).

newSubstr (substituição)

É a String que substitui a substring especificada pelo parâmetro regexp ou substr. Um número de padrões especiais para substituição são suportados; veja a seção "

Especificando uma string como parâmetro

" abaixo.

function (substituição)

Uma função a ser chamada retornando a nova substring a ser usada para substituir as correspondências para a dada regexp ou substr. Os argumentos passados para esta função são descritos na seção "Especificando uma função como parâmetro" abaixo.

Valor de retorno

Um nova string, com todas as ocorrências de um padrão substituído por uma substituição.

Descrição

Este método não muda o objeto String original. Ele simplesmente retorna uma nova string.

Especificando uma string como parâmetro

A string de substituição pode incluir os seguimentos padrões especiais de substituição:

Padrão Insere
$$ Insere um "$".
$& Insere a substring correspondente.
$` Insere a porção da string que precede a substring correspondente.
$' Insere a porção da string que sucede a substring correspondente.
$n Onde n é um inteiro positivo menor que 100, insere a n-ésima string submatch entre parênteses, desde que o primeiro argumento seja um objeto RegExp. Note que isso é indexado começando pelo 1.

Especificando uma função como parâmetro

Você pode especificar uma função como segundo parâmetro. Neste caso, a função será chamada depois da ocorrência ter sido encontrada. O resultado da função (valor de retorno) será usado como uma string para substituição. (Nota: Os padrões especiais mencionados acima não se aplicam neste caso.)

Note que a função será chamada múltiplas vezes para cada ocorrência a ser substituída se a expressão regular no primeiro parâmetro for global "g".

Os argumentos para funções são os seguintes:

Nome possível Valor fornecido
match A substring correspondida. (Corresponde ao $& acima.)
p1, p2, ... A n-ésima string encontrada por um grupo de captura entre parênteses, desde que o primeiro argumento para replace() seja uma RegExp. (Corresponde a $1, $2, etc. acima.) Por exemplo, se /(\a+)(\b+)/, foi dado, p1 é a correspondência para \a+, e p2 para \b+.
offset O deslocamento da substring correspondente em toda a string sendo examinada. (Por exemplo, se toda a string for 'abcd' e a substring correspondente for 'bc', este argumento será 1.)
string A string inteira será examinada.

(O número exato de argumentos depende se o primeiro argumento é um objeto RegExp — e, se então, quantas subcorrespondências entre parênteses são especificadas.)

Exemplos

Usando replaceAll()

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

RegExp sem flag "g" retorando erro

Ao usar uma expressão regular para realizar uma pesquisa, a mesma deve conter a flag global "g". O código abaixo não irá funcionar:

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

Já o código abaixo vai funcionar:

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

Especificações

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

Compatibilidade com navegadores

Enable JavaScript to view this browser compatibility table.

Veja também

Help improve MDN

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

This page was last modified on 24 de jun. de 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos Globais
  2. String
  3. Construtor
    1. String()
  4. Métodos estáticos
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.raw()
  5. Métodos de instância
    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.trimEnd()
    47. String.prototype.trimStart()
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
  6. Propriedades de instância
    1. String.length
  7. Herança
  8. Object/Function
  9. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  10. Propriedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  11. Métodos de instância
    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. Propriedades de instância
    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.