Substitui o texto com base em duas condições: o texto ou expressão RegEx e a tipo (flag).
Parâmetros
Nome
Tipo
Doc
Parâmetro 1
Texto
Texto original
Parâmetro 2
Texto
Condição para procurar o texto a ser substituído, podendo ser texto ou RegEx
Parâmetro 3
Texto
Adiciona um comportamento na expressão regular
Parâmetro 4
Texto
Novo texto
Compatibilidade
Cliente
Retorno
Retorna o texto após substituição.
Exemplo
A função abaixo (Figura 1) recebe na variável "texto" o blocoSubstituir com o parâmetroTexto originalrecebendo o texto a ser substituído, no parâmetroTexto ou RegEx a ser substituídocontém a expressão regularflor?para procurar as ocorrências que comecem com a palavra flor mas que não importa como terminem, o parâmetro Tipo usado no regex com a flag g, ou seja, a condição para procurar todas as ocorrências e no último parâmetro oNovo texto. Note que apesar de procurar todas as ocorrências que comecem com a palavra sugerida, ele substitui apenas a palavra flor por 22. Por fim, imprimea variável "texto" no console do navegador (Figura 2).
Figura 1 - Bloco Substituir
Figura 2 - Resultado no console
Sobre o bloco
O método percorre toda a string, caso a sequência de caracteres que atendem a condição não seja encontrada, o texto permanece inalterado; caso seja encontrada, uma nova string com a substituição é retornada.
Sobre RegEx ou expressão regular
É uma forma de identificar, através de expressões regulares, diversos caracteres, sejam eles em cadeia, individuais, palavras ou padrões.