English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método replace() da String JavaScript

 Objeto String do JavaScript

replace()O método é usado para substituir uma string por outra dentro de uma string, ou substituir uma substring que coincide com uma expressão regular.

O padrão pode ser uma string ou uma expressão regular, e a substituição pode ser uma string ou uma função chamada para cada coincidência.

Se o padrão for uma string, apenas a primeira ocorrência coincidente será substituída.

Para substituir todas as ocorrências de um valor específico, usegModificadores (busca global) (veja mais exemplos abaixo).

Você pode encontrarTutorial de RegExpeReferência do objeto RegExpObtenha mais informações sobre expressões regulares.

Atenção:Este método não altera o valor original da string.

Sintaxe:

string.replace(oldValue, newValue)
var str1 = 'The question is to be, or not to be, that is to be.';
var str2 = str1.replace('to be' 'ZZZ');
Teste e veja‹/›

Compatibilidade do navegador

Todos os navegadores suportam completamente o método replace():

Método
replace()SimSimSimSimSim

Valor do Parâmetro

ParâmetroDescrição
oldValueO valor ou expressão regular que será substituído pelo novo valor
newValueSubstitua o valor de busca (oldValue) com este valor

Detalhes Técnicos

Retorno:Uma nova string com parte ou todo o padrão correspondente é substituída pelo novo valor
Versão do JavaScript:ECMAScript 1

Mais Exemplos

Os seguintes exemplos mostram como usar o modificador globalgModificadores usados com replace():

var str1 = 'The question is to be, or not to be, that is to be.';
var str2 = str1.replace(/to be/g, 'ZZZ');
Teste e veja‹/›

Os seguintes exemplos mostram como usar o modificador global e ignoreCase com replace():

var str1 = 'The question is TO BE, or not to be, that is to be.';
var str2 = str1.replace(/to be/gi, 'ZZZ');
Teste e veja‹/›

 Objeto String do JavaScript