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.