Korjaa virheellinen prosenttikoodattu UTF-8
URL-arvo saapuu sovellukseen, mutta decodeURIComponent() aiheuttaa virheen URIError. Erota ennen välimerkkien korvaamista kaksi tilannetta: keskeneräinen prosenttikoodaus ja täydellinen tavukoodaus, joka ei ole kelvollista UTF-8:aa.
Etsi kohta, jossa arvo muuttuu
Oletetaan, että hakukenttä hyväksyy tekstin 50% off, mutta syntyneen linkin avaaminen kaataa sivun. Prosenttimerkki on hakukentässä tavallista tekstiä. Se muuttuu erikoismerkiksi vasta, kun koodi käsittelee tekstiä valmiiksi koodattuna URL-komponenttina. Kirjaa odotettu arvo jokaisessa rajakohdassa: käyttäjän teksti, sarjallistettu URL ja vastaanottavan sivun lukema arvo. Etsit koodausristiriitaa, et poistettavaa välimerkkiä.
Käytä vaaratonta näytettä äläkä kopioi oikeaa salasanan palautuslinkkiä tai asiakkaan hakua konsoliin tai julkiseen vikailmoitukseen. Kokeile ensin decodeURIComponent("%25"): tuloksen pitäisi olla yksi prosenttimerkki. Kokeile sitten virheellistä näytettä alla olevan ”Hylkää virheellinen syöte kaatamatta sivua” -kohdan suojatulla apufunktiolla. Jos kelvollinen vertailusyöte toimii mutta näyte ei, dekooderi ei ole yleisesti rikki; toimitettua tietoa pitää tutkia.
Erota keskeneräinen koodaus virheellisestä UTF-8:sta
Yksittäisellä merkillä % ei ole kahden numeron tavuarvoa. Sen sijaan %92 on syntaktisesti tavukoodaus, mutta kyseinen tavu ei voi esiintyä yksin UTF-8:ssa. Julkiset tapaukset näyttävät molempia virheitä, kuten vanhan koodauksen lainausmerkkitavuja ja yksittäisen arvon %AF.
decodeURIComponent("%"); // URIError
decodeURIComponent("%92"); // URIError
decodeURIComponent("%25"); // %
decodeURIComponent("%C2%AF"); // ¯
decodeURIComponent("%E2%80%99"); // ’
Säilytetty Node v24.19.0 -testi toisti tulokset ja testasi myös arvot %91, %AF sekä UTF-8:n vasemman lainausmerkin. Selaimen sanamuoto voi vaihdella; hyödyllistä näyttöä on täsmällisen syötteen hyväksyminen tai hylkääminen.
Muodosta kysely ilman prosenttikoodien käsin yhdistämistä
Anna uutta linkkiä varten alkuperäinen teksti URL API:lle ja anna sen sarjallistaa parametri. Lue vastaanottopäässä parametri saman API:n kautta. Älä dekoodaa palautettua arvoa heti uudelleen:
const link = new URL("https://example.com/search");
link.searchParams.set("q", "50% off & café");
const received = new URL(link.href).searchParams.get("q");
console.log(received); // 50% off & café
Tämä on esimerkkiosoite, ei FrAIFlow-päätepiste. Tärkeää on erottaa koodattu komponentti jo jäsennetystä arvosta. Toinen dekoodaus voi muuttaa täysin kelvollisen tekstin, kuten 50% off, poikkeukseksi. Muista myös, että lomakemuotoisten kyselyparametrien plusmerkkiä käsitellään eri tavalla kuin suoraan funktiolle decodeURIComponent() annettua kirjaimellista plusmerkkiä. Käytä muotoa vastaavaa jäsennintä.
Korjaa tuottaja arvaamatta merkkejä
Säilytä täsmällinen epäonnistuva näyte yksityisesti ja kysy tuottajalta käytettyä merkistökoodausta. Yksittäinen %92 voi viitata vanhaan tavukäytäntöön, mutta tavu ei yksin todista alkuperäänsä. Älä korvaa sitä hiljaisesti heittomerkillä tilitunnisteissa, allekirjoituksissa tai tiedostonimissä. Palauta hyödyllinen virhe, säilytä käyttäjän alkuperäinen syöte ja korjaa lähteen koodaus mahdollisuuksien mukaan.
Testaa muutoksen jälkeen kirjaimellinen prosentti, aksentillinen sana, kaareva lainausmerkki, plusmerkki ja et-merkki. Jokaisen pitää säilyä muuttumattomana ketjussa luo linkki → avaa linkki → lue arvo. Virheellisen syötteen pitää tuottaa hallittu virhe, ei pysäyttää muuta sivua. Tarkistukset varmistavat sovitun muodon; ne eivät oikeuta dekoodaamaan toistuvasti, kunnes teksti näyttää luettavalta.
Hylkää virheellinen syöte kaatamatta sivua
function decodeComponent(value) {
try { return { ok: true, value: decodeURIComponent(value) }; }
catch (error) {
if (!(error instanceof URIError)) throw error;
return { ok: false, error: "Invalid encoded component" };
}
}
Tämä rajakohta ilmoittaa virheestä muuttamatta tunnistetta hiljaisesti. Se ei tunnista tuntematonta lähdekoodausta. Dekoodaa vain sovitun muodon edellyttämä määrä: onnistuneen purun jälkeen jäljellä oleva prosenttimerkki ei oikeuta uuteen kierrokseen. Vältä vanhentunutta toimintoa unescape() UTF-8-korjauksena ja pidä tunnisteet sekä yksityiset kyselyarvot poissa julkisista diagnostiikkalokeista.
