Perché i simboli del dollaro cambiano il testo sostitutivo in JavaScript
Uno strumento Trova e sostituisci modifica il testo sostitutivo stesso. Anche cercando una stringa semplice, JavaScript interpreta le sequenze con dollaro nell’argomento di sostituzione. Se l’utente vuole testo letterale, restituiscilo da una funzione.
Riconosci i modelli di sostituzione prima di cambiare l’input
Immagina di sostituire un segnaposto con una spiegazione del prezzo contenente $&. L’utente si aspetta quei due caratteri, ma riappare il vecchio segnaposto. Non è necessariamente un problema di codifica. L’argomento sostitutivo ha un proprio piccolo linguaggio di modelli, anche quando la ricerca è una stringa semplice e non una regex.
Parti da una copia del testo e una sola corrispondenza. Se una sequenza con dollaro cambia, passa a una callback e confronta i risultati. Mantieni invariata la ricerca: cambiare entrambi gli input rende più difficile individuare la regola responsabile.
Una segnalazione pubblica del 2012 sostituiva un’intera stringa con $' ottenendo un risultato vuoto. Il token indica il suffisso dopo la corrispondenza. Poiché la corrispondenza consumava tutto, non rimaneva alcun suffisso.
const input = "as";
const replacement = "$'";
input.replace("as", replacement); // ""
input.replace("as", () => replacement); // "$'"
Il test conservato con Node.js v24.19.0 ha riprodotto entrambi i risultati. Altri token includono $$ per un dollaro, $& per la corrispondenza e riferimenti ai gruppi come $1 quando il pattern contiene il gruppo pertinente. Esistono anche forme per il prefisso e i gruppi con nome. Non ogni dollaro isolato è speciale.
Usa una callback quando l’utente intende testo letterale
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 $$.
Nella prima chiamata la stringa sostitutiva viene interpretata. Nella seconda la funzione restituisce il valore letterale dell’utente per ogni corrispondenza. Il risultato viene inserito senza un altro passaggio di interpretazione. Serve per strumenti che promettono normali sostituzioni, in cui l’utente non dovrebbe imparare escape speciali per incollare del testo.
Non risolvere costruendo automaticamente una regex dalla ricerca dell’utente. Una ricerca come a.b in modalità letterale dovrebbe trovare un punto, non un carattere qualsiasi. Se offri anche gruppi regex e modelli di sostituzione, usa una modalità avanzata separata e chiaramente indicata. Un modello come $1 è utile in quella modalità e non deve diventare letterale senza spiegazioni.
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);
}
Queste funzioni ricevono stringhe fornite dall’applicazione. Una sostituisce la prima occorrenza, l’altra tutte. Solo replaceLiteralAll rifiuta una ricerca vuota per evitare inserimenti fra unità di codice. Con una ricerca vuota, replaceLiteralOnce inserisce il testo sostitutivo all’inizio della stringa. Se il prodotto supporta intenzionalmente i modelli con gruppi, conserva e identifica quella modalità anziché cambiarne silenziosamente il significato.
Mostra l’intera modifica nel contesto finale
Mostra testo originale e modificato, soprattutto per Sostituisci tutto. Prova sostituzioni con un dollaro isolato, due dollari, un token di corrispondenza e una stringa vuota. Verifica l’assenza di corrispondenze. Una sostituzione vuota è una cancellazione legittima; una ricerca vuota richiede invece una decisione esplicita, perché può inserire testo fra posizioni lungo tutta la stringa.
Infine controlla la visualizzazione. Restituire testo letterale dalla callback non rende sicuro l’HTML. L’anteprima deve usare una textarea o textContent per il testo non attendibile, affinché un tag incollato venga mostrato e non eseguito. Salva o invia solo quando l’anteprima rispecchia l’intenzione e conserva la possibilità di annullare le modifiche massive.
I campioni registrati hanno conservato $&, $', $$ e $1 esattamente quando restituiti dalla callback. Aggiungi casi simili ai test di regressione, includendo corrispondenze ripetute e sostituzione vuota. Conserva la sorgente e mostra un’anteprima delle modifiche massive.
