JavaScript String substituir()
Exemplos
Substitua Microsoft:
let text = "Visit Microsoft!";
let result = text.replace("Microsoft", "W3Schools");
Uma substituição global:
let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/g, "red");
Mais exemplos abaixo.
Definição e uso
O replace()
método procura um valor ou uma expressão regular em uma string.
O replace()
método retorna uma nova string com os valores substituídos.
O replace()
método não altera a string original.
Observação
Se você substituir um valor, apenas a primeira instância será substituída. Para substituir todas as instâncias, use uma expressão regular com o conjunto de modificadores g.
Leia mais sobre expressões regulares em nosso:
Sintaxe
string.replace(searchValue, newValue)
Parâmetros
Parameter | Description |
searchValue | Required. The value, or regular expression, to search for. |
newValue | Required. The new value (to replace with). |
Valor de retorno
Modelo | Descrição |
Uma linha | Uma nova string em que os valores especificados foram substituídos. |
Mais exemplos
Uma substituição global que não diferencia maiúsculas de minúsculas:
let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/gi, "red");
Uma função para retornar o texto de substituição:
let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue|house|car/gi, function (x) {
return x.toUpperCase();
});
Suporte ao navegador
replace()
é um recurso ECMAScript1 (ES1).
ES1 (JavaScript 1997) é totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |