JavaScript String replaceAll()
- Página anterior replace()
- Próxima página search()
- Voltar à página anterior Manual de Referência JavaScript String
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:
Exemplo
Exemplo 1
text = text.replaceAll("Cats","Dogs"); text = text.replaceAll("cats","dogs");
Exemplo 2
text = text.replaceAll(/Cats/g,"Dogs"); text = text.replaceAll(/cats/g,"dogs");
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");
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(); });
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. |
- Página anterior replace()
- Próxima página search()
- Voltar à página anterior Manual de Referência JavaScript String