JavaScript replace()Método

String 对象参考手册Objeto String de JavaScript

Ejemplo

En este ejemplo, realizaremos un reemplazo: cuando se encuentre el primer "Microsoft", se reemplazará por "Ejemplo":

var str="Visit Microsoft! Visit Microsoft!"; var n=str.replace("Microsoft","Ejemplo");

nResultado:

Visit Ejemplo!Visit Microsoft!

Pruébalo »

Definición y uso

El método replace() se utiliza para reemplazar algunos caracteres por otros en una cadena, o para reemplazar una subcadena que coincida con una expresión regular.

Si desea obtener más información sobre los tutoriales de expresiones regulares, consulte los de este sitio:Tutorial de RegExpy nuestroManual de referencia del objeto RegExp.

Este método no cambia la cadena original.


Soporte del navegador

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Todos los navegadores principales admiten el método replace().


Sintaxis

string.replace(searchvalue,newvalue)

Valores de parámetros

Parámetro Descripción
searchvalue Obligatorio. Especifica una subcadena o un objeto RegExp con el patrón a reemplazar.
Tenga en cuenta que si el valor es una cadena, se utilizará como un patrón de texto literal para buscar, en lugar de convertirse primero en un objeto RegExp.
newvalue Obligatorio. Un valor de cadena. Especifica el texto de reemplazo o una función que genera el texto de reemplazo.

Valor de retorno

Tipo Descripción
String Una nueva cadena, obtenida al reemplazar la primera coincidencia o todas las coincidencias de regexp con replacement.

Detalles técnicos

Versión de JavaScript: 1.2


Más ejemplos

Ejemplo

Realizar un reemplazo global:

var str="Mr Blue has a blue house and a blue car"; var n=str.replace(/blue/g,"red");

nResultado:

Mr Blue has a red house and a red car

Pruébalo »

Ejemplo

Realizar un reemplazo global, ignorando mayúsculas y minúsculas:

var str="Mr Blue has a blue house and a blue car"; var n=str.replace(/blue/gi, "red");

nResultado:

Mr red has a red house and a red car

Pruébalo »

Ejemplo

En este ejemplo, agregamos un método al objeto String de JavaScript mediante prototype para reemplazar todas las apariciones de "Microsoft" por "Ejemplo":

String.prototype.replaceAll = function(search, replacement) { var target = this; return target.replace(new RegExp(search, 'g'), replacement); };

Pruébalo »


String 对象参考手册Objeto String de JavaScript

Otras extensiones