Siirry sisältöön
FrAIFlow

Ratkaisut / Teksti & koodi

Miksi dollarimerkit muuttavat JavaScriptin korvaustekstiä

Etsi ja korvaa -työkalu muuttaa itse korvaustekstiä. JavaScript tulkitsee dollarijonoja korvausargumentissa, vaikka haku olisi tavallinen merkkijono. Jos käyttäjä tarkoittaa tekstiä kirjaimellisesti, palauta se funktiosta.

Yksi arvo, kaksi tulkintaa
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

Tunnista korvausmallit ennen syötteen muuttamista

Kuvittele korvaavasi paikkamerkin hintaselityksellä, jossa on $&. Käyttäjä odottaa näitä kahta merkkiä, mutta vanha paikkamerkki ilmestyy takaisin. Kyse ei välttämättä ole merkistökoodauksesta. Korvausargumentilla on oma pieni mallikielensä silloinkin, kun haku on tavallinen merkkijono eikä säännöllinen lauseke.

Aloita tekstin kopiosta ja yhdestä osumasta. Jos dollarijono muuttuu, vaihda korvausargumentiksi callback-funktio ja vertaa tuloksia. Pidä haku samana vertailussa. Molempien syötteiden samanaikainen muuttaminen vaikeuttaa yllätyksen aiheuttaneen säännön tunnistamista.

Vuoden 2012 julkisessa tapauksessa koko merkkijono korvattiin arvolla $' ja saatiin tyhjä tulos. Token tarkoittaa osuman jälkeistä loppuosaa. Koska osuma kattoi kaiken, loppuosaa ei ollut.

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

Säilytetty Node.js v24.19.0 -testi toisti molemmat tulokset. Muita korvaustokeneita ovat $$ dollarimerkille, $& osumalle sekä ryhmäviittaukset kuten $1, kun hakumallissa on vastaava ryhmä. Lisäksi on etuliite- ja nimettyjen ryhmien muotoja. Jokainen dollarimerkki ei yksinään ole erikoismerkki.

Pidä kaksi toimintatilaa erillisinä
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

Käytä callbackia, kun käyttäjä tarkoittaa kirjaimellista tekstiä

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 $$.

Ensimmäisessä kutsussa korvausmerkkijono tulkitaan. Toisessa funktio palauttaa käyttäjän kirjaimellisen arvon jokaiselle osumalle. Paluuarvo lisätään ilman uutta korvausmallin tulkintaa. Tämä sopii tavallista etsi ja korvaa -toimintoa lupaaviin työkaluihin, joissa käyttäjän ei pitäisi opetella dollarin erikoissuojausta pelkkää tekstin liittämistä varten.

Älä ratkaise ongelmaa muodostamalla käyttäjän hausta automaattisesti säännöllistä lauseketta. Haun a.b pitäisi kirjaimellisessa tilassa yleensä löytää piste, ei mikä tahansa merkki. Jos tarjoat myös regex-ryhmiä ja korvausmalleja, pidä ne erillisenä selvästi nimettynä lisätilana. Malli kuten $1 on hyödyllinen siinä tilassa eikä saa muuttua yllättäen kirjaimelliseksi ilman selitystä.

Merkkijonokorvaus tulkitsee dollaritokenit; callback säilyttää annetun dollaritekstin täsmälleen.
Tekijän laatima ennen–jälkeen-selitys yllä olevan synteettisen Node.js-esimerkin täsmällisestä tuloksesta. Ei tekstieditorin kuvakaappaus. Avaa kuva täysikokoisena.
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);
}

Apufunktiot odottavat sovelluksen toimittamia merkkijonoja. Toinen korvaa ensimmäisen esiintymän, toinen kaikki. Vain replaceLiteralAll hylkää tyhjän hakumerkkijonon ja estää näin lisäykset koodiyksikköjen väliin. Kun hakumerkkijono on tyhjä, replaceLiteralOnce lisää korvaavan tekstin merkkijonon alkuun. Jos tuotteesi tarkoituksella tukee ryhmäviittausmalleja, säilytä tila ja nimeä se selvästi äläkä muuta sen merkitystä hiljaisesti.

Esikatsele koko muutos lopullisessa yhteydessään

Näytä alkuperäinen ja muutettu teksti, erityisesti Korvaa kaikki -toiminnossa. Testaa yksittäinen dollarimerkki, kaksi dollarimerkkiä, osumatoken ja tyhjä korvaus. Tarkista myös tilanne, jossa osumia ei ole. Tyhjä korvaus tarkoittaa kelvollista poistoa; tyhjän haun toiminta on päätettävä erikseen, koska se voi lisätä tekstiä merkkijonon kaikkiin väleihin.

Tarkista lopuksi tuloksen näyttäminen. Kirjaimellisen tekstin palauttaminen callbackista ei tee HTML:stä turvallista. Esikatselun tulisi käyttää epäluotetulle tekstille tekstialuetta tai textContent, jotta liitetty tagi näytetään eikä suoriteta. Tallenna tai lähetä vasta, kun esikatselu vastaa käyttäjän tarkoitusta, ja säilytä joukkokorvauksille kumoamispolku.

Tallennetut testit säilyttivät arvot $&, $', $$ ja $1 täsmälleen callbackista palautettaessa. Lisää vastaavia esimerkkejä omiin regressiotesteihisi, myös toistuvat osumat ja tyhjä korvaus. Säilytä lähde ja esikatsele joukkokorvaukset.

Mitattu korvaus: merkkijonoargumentti tuottaa tyhjän tuloksen; funktio palauttaa kirjaimellisen dollarin ja heittomerkin.
Säilytetty alkuperäinen selitys.
Synteettisen testin tallennettu tulos: miksi dollarimerkit muuttavat JavaScriptin korvaustekstiä
Tallennettu Node.js-merkkijonokorvauksen tulos kirjaimellisella dollarimerkkitekstillä. Kuva esittää tallennettua testitulosta, ei alkuperäisen ilmoittajan sovellusta. Avaa täysikokoinen testikuva.

Lähteet ja lisälukeminen