O métodoreplaceAll() 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 umaRegExp, e a substituição pode ser uma string ou uma função a ser chamada para cada ocorrência.

Astring original é mantida sem modificação.

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 regexconst 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)

Parâmetros

regexp (padrão)

UmaRegExp ou literal com o sinalizador (flag) global. As ocorrências serão substituídas pornewSubstr ou pelo valor retornado dafunction (função) especificada.

substr (padrão)

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

newSubstr (substituição)

É aString que substitui asubstring especificada pelo parâmetroregexp ousubstr. 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 novasubstring a ser usada para substituir as correspondências para a dadaregexp ousubstr. 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 novastring, com todas as ocorrências de um padrão substituído por uma substituição.

Descrição

Este método não muda o objetoString original. Ele simplesmente retorna uma novastring.

Especificando uma string como parâmetro

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

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 umastring para substituição. (Nota: Os padrões especiais mencionados acimanã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:

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

Exemplos

UsandoreplaceAll()

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

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

Já o código abaixo vai funcionar:

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

Especificações

Compatibilidade com navegadores

Veja também

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