Waarom dollartekens je vervangingstekst in JavaScript veranderen
Een zoek-en-vervangtool verandert de vervangingstekst zelf. Zelfs bij een gewone string als zoekterm interpreteert JavaScript dollarreeksen in het vervangingsargument. Wil de gebruiker letterlijke tekst invoegen, geef die tekst dan terug vanuit een functie.
Herken vervangingssjablonen voordat je de invoer verandert
Stel dat je een placeholder vervangt door een prijsuitleg met $&. De gebruiker verwacht die twee tekens, maar de oude placeholder verschijnt opnieuw. Dit hoeft geen coderingsprobleem te zijn. Het vervangingsargument heeft een eigen kleine sjabloontaal, zelfs wanneer de zoekterm een gewone string is en geen reguliere expressie.
Begin met een kopie van de tekst en één overeenkomst. Verandert een dollarreeks, vervang het vervangingsargument dan door een callback en vergelijk de resultaten. Houd de zoekterm gelijk. Beide invoeren tegelijk wijzigen maakt het lastiger te zien welke regel de verrassing veroorzaakte.
In een openbare melding uit 2012 werd een hele string vervangen door $', met een leeg resultaat. Dat token betekent het achtervoegsel na de overeenkomst. Omdat de overeenkomst alles omvatte, was er geen achtervoegsel.
const input = "as";
const replacement = "$'";
input.replace("as", replacement); // ""
input.replace("as", () => replacement); // "$'"
De bewaarde Node.js v24.19.0-test reproduceerde beide uitkomsten. Andere vervangingstokens zijn $$ voor een dollarteken, $& voor de overeenkomst en verwijzingen naar vastgelegde groepen zoals $1 als het patroon die groep bevat. Er bestaan ook vormen voor het voorvoegsel en voor benoemde groepen. Niet elk los dollarteken heeft een bijzondere betekenis.
Gebruik een callback als de gebruiker letterlijke tekst bedoelt
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 $$.
In de eerste aanroep wordt de vervangingsstring geïnterpreteerd. In de tweede geeft de functie voor elke overeenkomst de letterlijke gebruikerswaarde terug. Die wordt ingevoegd zonder een nieuwe sjablooninterpretatie. Dit is handig voor tools die gewone zoek-en-vervang beloven: de gebruiker hoeft geen speciale dollar-escaping te leren om tekst te plakken.
Los dit niet op door automatisch een reguliere expressie te maken van de zoekterm. Een zoekterm zoals a.b hoort in letterlijke modus meestal een letterlijke punt te vinden, niet elk willekeurig teken. Bied een afzonderlijke, duidelijk aangeduide geavanceerde modus als je ook regexgroepen en vervangingssjablonen ondersteunt. Een sjabloon zoals $1 is daar nuttig en mag niet zonder uitleg opeens letterlijk worden behandeld.
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);
}
Deze functies verwachten strings die de toepassing aanlevert. De ene vervangt de eerste overeenkomst, de andere alle overeenkomsten. Alleen replaceLiteralAll weigert een lege zoekterm om invoegingen tussen code-eenheden te voorkomen. Bij een lege zoekterm voegt replaceLiteralOnce de vervangende tekst aan het begin van de string in. Ondersteunt je product bewust groepssjablonen, behoud en benoem die modus dan duidelijk in plaats van de betekenis stilzwijgend te veranderen.
Controleer het volledige resultaat op de plek waar je het gebruikt
Toon zowel de oorspronkelijke als de gewijzigde tekst, vooral bij Alles vervangen. Test een vervanging met één dollarteken, twee dollartekens, een overeenkomstreeks en een lege string. Controleer ook wat er gebeurt zonder overeenkomst. Een lege vervanging is een geldige verwijdering; een lege zoekterm vraagt om een expliciete productkeuze omdat er door de hele string tekst tussen posities kan worden ingevoegd.
Controleer ten slotte hoe het resultaat wordt weergegeven. Letterlijke tekst uit een callback teruggeven maakt HTML niet veilig. Gebruik voor onbetrouwbare tekst in een preview een textarea of textContent, zodat een geplakte tag wordt getoond en niet uitgevoerd. Sla pas op of verstuur pas wanneer de preview overeenkomt met de bedoeling, en zorg bij bulkbewerkingen voor een manier om wijzigingen terug te draaien.
De geregistreerde testvoorbeelden behielden $&, $', $$ en $1 exact wanneer de callback ze teruggaf. Voeg vergelijkbare gevallen toe aan je regressietests, inclusief herhaalde overeenkomsten en een lege vervanging. Bewaar de bron en bekijk bulkbewerkingen vooraf.
