<JavaScript string de referência
Exemplo
Retorna uma string em que "Microsoft" é substituído por "w3ii" :
var str = "Visit Microsoft!";
var res = str.replace("Microsoft", "w3ii");
O resultado da res será:
Visit w3ii!
Tente você mesmo " Mais "Try it Yourself" exemplos abaixo.
Definição e Uso
O replace() método procura uma string para um valor especificado, ou uma expressão regular e retorna uma nova cadeia, onde os valores especificados são substituídos.
Nota: Se você estiver substituindo um valor (e não uma expressão regular), apenas a primeira instância do valor será substituído. Para substituir todas as ocorrências de um valor especificado, use o mundial (g) modificador (ver "More Examples" abaixo).
Leia mais sobre expressões regulares no nosso Tutorial RegExp e nossa RegExp Object Reference .
Este método não altera a string original.
Suporte navegador
Método | |||||
---|---|---|---|---|---|
replace() | sim | sim | sim | sim | sim |
Sintaxe
Os valores dos parâmetros Parâmetro Descrição searchvalue Requeridos. O valor, ou a expressão regular, que será substituído pelo novo valor newvalue Requeridos. O valor para substituir o valor de pesquisa com
Detalhes técnicos
Valor de retorno: Uma nova sequência, onde o especificado value(s) tem sido substituído pelo novo valor JavaScript Versão: 1,2
mais Exemplos
Exemplo
Execute um substituto mundial:
var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/g, "red");
O resultado da res será:
Mr Blue has a red house and a red car
Tente você mesmo "
Exemplo
Executar uma substituição global, caso- insensível:
var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/gi, "red");
O resultado da res será:
Mr red has a red house and a red car
Tente você mesmo "
Exemplo
Usando uma função para retornar o texto de substituição:
var str = "Mr Blue has a blue house and a blue car";
var res =
str.replace(/blue|house|car/gi, function myFunction(x){return x.toUpperCase();}); O resultado da res será:
Mr BLUE has a BLUE HOUSE and a BLUE CAR. Tente você mesmo "
<JavaScript string de referência