Varför dollartecken ändrar din ersättningstext i JavaScript
Ett sök-och-ersätt-verktyg ändrar själva ersättningstexten. Även vid vanlig strängsökning tolkar JavaScript dollarsekvenser i ersättningsargumentet. Om användaren menar bokstavlig text ska den returneras från en funktion.
Identifiera ersättningsmallar innan du ändrar indata
Tänk dig att du ersätter en platshållare med en prisförklaring som innehåller $&. Användaren väntar sig de två tecknen, men den gamla platshållaren kommer tillbaka. Det är inte nödvändigtvis ett teckenkodningsproblem. Ersättningsargumentet har ett eget litet mallspråk, även när sökningen är en vanlig sträng och inte ett reguljärt uttryck.
Börja med en kopia av texten och en enda träff. Om en dollarsekvens ändras byter du ersättningsargumentet till en callback och jämför resultaten. Behåll samma sökning under jämförelsen. Om båda indata ändras samtidigt blir det svårare att se vilken regel som orsakade överraskningen.
En offentlig rapport från 2012 ersatte en hel sträng med $' och fick ett tomt resultat. Den token betecknar suffixet efter träffen. Eftersom träffen omfattade allt fanns inget suffix kvar.
const input = "as";
const replacement = "$'";
input.replace("as", replacement); // ""
input.replace("as", () => replacement); // "$'"
Det bevarade Node.js v24.19.0-testet återskapade båda utfallen. Andra ersättningstoken är bland annat $$ för ett dollartecken, $& för träffen och gruppreferenser som $1 när mönstret har motsvarande grupp. Det finns också former för prefix och namngivna grupper. Varje enskilt dollartecken har inte specialbetydelse.
Använd en callback när användaren menar bokstavlig text
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 $$.
I det första anropet tolkas ersättningssträngen. I det andra returnerar funktionen användarens bokstavliga värde för varje träff. Returvärdet sätts in utan ytterligare tolkning som ersättningsmall. Det passar verktyg som lovar vanlig sök-och-ersätt, där användaren inte ska behöva lära sig särskild dollar-escape bara för att klistra in text.
Lös inte problemet genom att automatiskt skapa ett reguljärt uttryck av användarens sökning. En sökning som a.b ska i bokstavligt läge normalt hitta en faktisk punkt, inte valfritt tecken. Behåll ett separat, tydligt märkt avancerat läge om du även erbjuder regex-grupper och ersättningsmallar. En mall som $1 är användbar där och ska inte plötsligt bli bokstavlig utan förklaring.
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);
}
Hjälpfunktionerna förväntar sig strängar från applikationen. Den ena ersätter första förekomsten, den andra alla matchande förekomster. Endast replaceLiteralAll avvisar en tom sökning för att förhindra insättningar mellan kodenheter. Vid en tom sökning infogar replaceLiteralOnce ersättningstexten i början av strängen. Om produkten avsiktligt stöder gruppmallar ska det läget bevaras och märkas tydligt i stället för att betydelsen ändras tyst.
Förhandsgranska hela ändringen i sitt slutliga sammanhang
Visa både originalet och den ändrade texten, särskilt vid Ersätt alla. Testa ersättning med ett ensamt dollartecken, två dollartecken, en träff-token och en tom sträng. Kontrollera vad som händer utan träff. Tom ersättning är en legitim radering; tom sökning kräver ett uttryckligt produktbeslut eftersom den kan sätta in text mellan positioner genom hela strängen.
Kontrollera till sist hur resultatet visas. Bokstavlig text från en ersättningscallback gör inte HTML säker. En förhandsvisning bör använda textarea eller textContent för obetrodd text, så att inklistrade taggar visas i stället för att köras. Spara eller skicka först när förhandsvisningen motsvarar användarens avsikt och behåll en ångerväg för massändringar.
De registrerade testfallen bevarade $&, $', $$ och $1 exakt när de returnerades av callbacken. Lägg till liknande exempel i egna regressionstester, inklusive upprepade träffar och tom ersättning. Behåll källan och förhandsgranska massändringar.
