Spring til indholdet
FrAIFlow

Løsninger / Tekst & Kode

Hvorfor dollartegn ændrer din erstatningstekst i JavaScript

Et søg-og-erstat-værktøj ændrer selve erstatningsteksten. Selv ved søgning efter en almindelig streng fortolker JavaScript dollarsekvenser i erstatningsargumentet. Hvis brugeren mener bogstavelig tekst, skal du returnere teksten fra en funktion.

Én værdi, to fortolkninger
Forklaring fremstillet af forfatteren ud fra det bevarede eksempel; ikke et skærmbillede fra et program.

Identificér erstatningsskabeloner, før du ændrer input

Forestil dig, at du erstatter en pladsholder med en prisforklaring, som indeholder $&. Brugeren forventer disse to tegn, men den gamle pladsholder dukker op igen. Det er ikke nødvendigvis et tegnkodningsproblem. Erstatningsargumentet har sit eget lille skabelonsprog, selv når søgningen er en almindelig streng og ikke et regulært udtryk.

Start med en kopi af teksten og ét match. Hvis en dollarsekvens ændrer sig, skal du skifte erstatningsargumentet til en callback og sammenligne resultaterne. Behold søgningen uændret under sammenligningen. Hvis begge input ændres samtidig, bliver det sværere at se, hvilken regel der skabte overraskelsen.

En offentlig rapport fra 2012 erstattede en hel streng med $' og fik et tomt resultat. Dette token betyder teksten efter matchet. Fordi matchet omfattede alt, var der ingen efterfølgende tekst.

const input = "as";
const replacement = "$'";
input.replace("as", replacement);       // ""
input.replace("as", () => replacement); // "$'"

Den bevarede Node.js v24.19.0-test genskabte begge resultater. Andre erstatningstokens omfatter $$ for et dollartegn, $& for matchet og gruppereferencer som $1, når mønstret har den pågældende gruppe. Der findes også former for foranstillet tekst og navngivne grupper. Ikke ethvert dollartegn har en særlig betydning alene.

Gør de to tilstande tydelige
Forklaring fremstillet af forfatteren ud fra det bevarede eksempel; ikke et skærmbillede fra et program.

Brug en callback, når brugeren mener bogstavelig tekst

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ørste kald fortolkes erstatningsstrengen. I det andet returnerer funktionen brugerens bogstavelige værdi for hvert match. Returværdien indsættes uden endnu en fortolkning som erstatningsskabelon. Det er nyttigt i værktøjer, som lover almindelig søg-og-erstat, hvor brugeren ikke bør skulle lære særlige dollar-escapingregler blot for at indsætte tekst.

Løs ikke problemet ved automatisk at bygge et regulært udtryk ud fra brugerens søgning. En søgning som a.b bør normalt finde et bogstaveligt punktum i bogstavelig tilstand, ikke et vilkårligt tegn. Behold en særskilt, tydeligt mærket avanceret tilstand, hvis du også tilbyder regex-grupper og erstatningsskabeloner. En skabelon som $1 er nyttig i den tilstand og bør ikke pludselig blive bogstavelig uden forklaring.

Strengerstatningen fortolker dollartokens; callbacken bevarer den indtastede dollartekst nøjagtigt.
Forfatterens før-og-efter-forklaring af præcis det syntetiske Node.js-eksempel ovenfor. Ikke et skærmbillede fra en teksteditor. Åbn billedet for detaljer i fuld størrelse.
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);
}

Disse hjælpefunktioner forventer strenge leveret af programmet. Den ene erstatter første forekomst; den anden erstatter alle matchende forekomster. Kun replaceLiteralAll afviser en tom søgning for at forhindre indsættelser mellem kodeenheder. Ved en tom søgning indsætter replaceLiteralOnce erstatningsteksten i starten af strengen. Hvis produktet bevidst understøtter gruppeskabeloner, skal du bevare og tydeligt mærke den tilstand frem for ubemærket at ændre betydningen.

Forhåndsvis hele ændringen i dens endelige sammenhæng

Vis både original og ændret tekst, især ved Erstat alle. Test en erstatning med ét dollartegn, to dollartegn, et match-token og en tom streng. Kontrollér, hvad der sker uden match. En tom erstatning er en legitim sletning; en tom søgning kræver et udtrykkeligt produktvalg, fordi den kan indsætte tekst mellem positioner gennem hele strengen.

Kontrollér til sidst, hvordan resultatet vises. Bogstavelig tekst fra en erstatningscallback gør ikke HTML sikkert. En forhåndsvisning bør bruge et textarea eller textContent til tekst, der ikke er betroet, så et indsat tag vises frem for at blive udført. Gem eller indsend først, når forhåndsvisningen matcher brugerens hensigt, og behold en fortrydelsesmulighed ved masseændringer.

De registrerede testdata bevarede $&, $', $$ og $1 nøjagtigt, når callbacken returnerede dem. Tilføj lignende eksempler til dine egne regressionstests, herunder gentagne match og tom erstatning. Behold kilden, og forhåndsvis masseændringer.

Målt erstatning: strengargumentet giver tomt output; funktionen returnerer det bogstavelige dollartegn og apostrof.
Bevaret oprindelig forklaring.
Registreret syntetisk testoutput for dollartegn, der ændrer erstatningstekst i JavaScript
Registreret Node.js-strengerstatningsoutput med bogstavelig dollartekst. Dette er et billede af registreret testoutput, ikke fejlrapportørens oprindelige program. Åbn dokumentationsbilledet i fuld størrelse.

Kilder og relateret læsning