JavaScript String replaceAll()

Definição e uso

replaceAll() O método é usado para procurar um valor específico ou expressão regular em uma string.

replaceAll() O método retorna uma nova string com todos os valores correspondentes substituídos.

replaceAll() O método não altera a string original.

replaceAll() O método foi introduzido no JavaScript 2021.

replaceAll() O método não está disponível no Internet Explorer.

Atenção

Se o parâmetro for uma expressão regular, é necessário definir o sinalizador global (g),caso contrário, será lançado um TypeError.

Para mais informações sobre expressões regulares, consulte:

Tutorial de expressão regular

Referência de expressão regular

Exemplo

Exemplo 1

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

Experimente você mesmo

Exemplo 2

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

Experimente você mesmo

Exemplo 2

Substituição global, insensível a maiúsculas e minúsculas:

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

Experimente você mesmo

Exemplo 3

Usar função para retornar o texto substituído:

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();
});

Experimente você mesmo

Sintaxe

string.replaceAll(searchValue, newValue)

Parâmetros

Parâmetros Descrição
searchValue Obrigatório. O valor ou expressão regular a ser pesquisado.
newValue Obrigatório. O novo valor a ser substituído. Pode ser uma função JavaScript.

Valor retornado

Tipo Descrição
String Retorna uma nova string onde todos os valores correspondentes foram substituídos.