Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.replace — reemplazar texto

replace() devuelve un texto con las coincidencias reemplazadas, sin modificar el original. Aprende la diferencia entre buscar con cadenas y con expresiones regulares, y entre las plantillas de reemplazo y las funciones de reemplazo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

text.replace(searchValue, replaceValue)

String.prototype.replace devuelve una cadena nueva cuando se usa con una cadena simple o un RegExp estándar; el original no cambia. Si no hay coincidencias, devuelve el contenido sin modificar. Es una API del lenguaje ECMAScript, no una API del navegador.

Un searchValue de tipo cadena se interpreta literalmente y solo reemplaza la primera aparición; una cadena vacía coincide al principio. Un RegExp estándar sin g reemplaza como máximo una coincidencia; con g, reemplaza todas las coincidencias encontradas. Un objeto con un método [Symbol.replace] puede definir un comportamiento personalizado, incluido el resultado.

Un replaceValue de tipo cadena interpreta $$ como $, $& como la coincidencia completa y $1 como el primer grupo de captura existente. Una función de reemplazo recibe la coincidencia, después los grupos capturados, el índice y la cadena de entrada; si hay grupos con nombre, se añade al final un objeto groups. El índice cuenta unidades de código UTF-16. El resultado de la función se convierte en una cadena, pero las secuencias $ no se interpretan.

El ejemplo compara el reemplazo de la primera coincidencia, el reemplazo global, una referencia a un grupo capturado y el resultado literal de una función. Imprimir text también permite comprobar que el original no cambia.

Ejemplos

const text = "cat cat";
console.log(text.replace("cat", "dog"));
console.log(text.replace(/cat/g, "dog"));
console.log(text.replace(/(cat)/g, "[$1]"));
console.log(text.replace(/cat/g, () => "$&"));
console.log(text);

Resultado

dog cat
dog dog
[cat] [cat]
$& $&
cat cat

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes