tutoriais mais recente desenvolvimento web
 

JavaScript Corda replace() Method

<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

Exemplos

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