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

CKTIS / JavaScript

String.prototype.replaceAll — reemplazar todas las coincidencias

replaceAll reemplaza todas las coincidencias no solapadas de una cadena o una expresión regular global sin modificar la cadena original. El reemplazo puede ser texto o una función.

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.replaceAll(searchValue, replaceValue)

Con un patrón de cadena, String.prototype.replaceAll devuelve una cadena en la que se reemplaza cada coincidencia no solapada de izquierda a derecha. No modifica la cadena original ni vuelve a buscar en el texto insertado. Si no hay coincidencias, el contenido del resultado permanece igual. A diferencia de replace con un patrón de cadena, no se detiene tras la primera coincidencia.

Un searchValue de tipo cadena se interpreta literalmente: "." significa un punto, no cualquier carácter. Una expresión regular debe tener la marca g; si falta, se produce un TypeError. Un patrón de cadena vacío coincide con cada límite de unidad de código UTF-16, incluidos el principio y el final: "ab".replaceAll("", "-") produce "-a-b-". Un objeto con un método [Symbol.replace] puede hacerse cargo de la operación y determinar su resultado.

replaceValue puede ser texto o una función. En el texto de reemplazo, $$ significa un signo de dólar y $& representa la coincidencia; las expresiones regulares también admiten referencias a grupos de captura. Para insertar literalmente texto dinámico que contenga estas secuencias, usa () => replacement. Con un patrón de cadena, la función recibe (match, offset, string); con una expresión regular, recibe además los grupos de captura antes del desplazamiento y, si hay grupos con nombre, un objeto de grupos con nombre al final.

Este método pertenece a ECMAScript 2021, no a las Web APIs. La especificación no es una tabla de compatibilidad de navegadores; que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad en el navegador. Comprueba el entorno de destino, por ejemplo con typeof String.prototype.replaceAll === "function".

Ejemplos

const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);

Resultado

a-b-a
A.b.A
$&.b.$&
a.b.a

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