Por qué los signos de dólar cambian el texto de sustitución en JavaScript
Una herramienta de buscar y reemplazar modifica el propio texto de sustitución. Incluso si busca una cadena literal, JavaScript interpreta las secuencias con dólar del argumento de reemplazo. Si el usuario quiere insertar texto literal, devuélvalo desde una función.
Identifique las plantillas de reemplazo antes de cambiar la entrada
Imagine que sustituye un marcador por una explicación de precios que contiene $&. El usuario espera esos dos caracteres, pero reaparece el marcador anterior. No tiene por qué ser un problema de codificación. El argumento de sustitución tiene su propio pequeño lenguaje de plantillas, incluso cuando la búsqueda es una cadena normal y no una expresión regular.
Empiece con una copia del texto y una sola coincidencia. Si cambia una secuencia con dólar, sustituya el argumento de reemplazo por una función callback y compare los resultados. Mantenga igual la búsqueda. Cambiar ambas entradas a la vez dificulta identificar la regla que provocó la sorpresa.
Una consulta pública de 2012 describía la sustitución de una cadena completa por $' con un resultado vacío. Ese token representa el sufijo posterior a la coincidencia. Como la coincidencia abarcaba todo el texto, no quedaba sufijo.
const input = "as";
const replacement = "$'";
input.replace("as", replacement); // ""
input.replace("as", () => replacement); // "$'"
La prueba conservada de Node.js v24.19.0 reprodujo ambos resultados. Otros tokens de reemplazo incluyen $$ para un signo de dólar, $& para la coincidencia y referencias a capturas como $1 cuando el patrón contiene el grupo correspondiente. También hay formas para el prefijo y las capturas con nombre. Un signo de dólar aislado no siempre tiene un significado especial.
Use una función cuando el usuario quiera texto literal
const draft = "Price: TOKEN. Repeat: TOKEN.";
const typedReplacement = "$& costs $$";
console.log(draft.replaceAll("TOKEN", typedReplacement));
// Price: TOKEN costs $. Repeat: TOKEN costs $.
console.log(draft.replaceAll("TOKEN", () => typedReplacement));
// Price: $& costs $$. Repeat: $& costs $$.
En la primera llamada se interpreta la cadena de reemplazo. En la segunda, la función devuelve el valor literal del usuario para cada coincidencia. Ese valor se inserta sin volver a procesarlo como plantilla. Esto resulta útil para herramientas que prometen buscar y reemplazar texto normal, sin obligar al usuario a aprender escapes especiales para pegar un texto con dólares.
No lo resuelva construyendo automáticamente una expresión regular a partir de la búsqueda del usuario. Una búsqueda como a.b normalmente debería encontrar un punto literal en modo literal, no cualquier carácter. Si también ofrece capturas y plantillas de expresiones regulares, mantenga un modo avanzado separado y claramente identificado. Una plantilla como $1 es útil en ese modo y no debería pasar a interpretarse como texto literal sin explicarlo.
function replaceLiteralOnce(text, search, value) {
return text.replace(search, () => value);
}
function replaceLiteralAll(text, search, value) {
if (search === "") throw new Error("Search must not be empty");
return text.replaceAll(search, () => value);
}
Estas funciones esperan cadenas proporcionadas por la aplicación. Una reemplaza la primera coincidencia y la otra todas las coincidencias. Solo replaceLiteralAll rechaza una búsqueda vacía para evitar inserciones entre unidades de código. Con una búsqueda vacía, replaceLiteralOnce inserta el texto de reemplazo al principio de la cadena. Si su producto admite deliberadamente plantillas de captura, conserve ese modo e identifíquelo con claridad en lugar de cambiar silenciosamente su significado.
Revise la edición completa en su contexto final
Muestre el texto original y el modificado, especialmente al usar Reemplazar todo. Pruebe una sustitución con un dólar aislado, dos dólares, un token de coincidencia y una cadena vacía. Compruebe también el caso sin coincidencias. Un reemplazo vacío es una eliminación válida; una búsqueda vacía exige una decisión explícita del producto, porque puede insertar texto entre posiciones de toda la cadena.
Por último, compruebe cómo se muestra el resultado. Devolver texto literal desde una función de reemplazo no hace seguro el HTML. Para texto no fiable, la vista previa debe usar un textarea o textContent, de modo que una etiqueta pegada se muestre en lugar de ejecutarse. Guarde o envíe únicamente cuando la vista previa coincida con la intención del usuario y conserve una forma de deshacer las ediciones masivas.
Los ejemplos registrados conservaron $&, $', $$ y $1 exactamente cuando los devolvió la función. Añada casos similares a sus pruebas de regresión, incluidas coincidencias repetidas y sustituciones vacías. Conserve el original y previsualice los cambios masivos.
