Siirry sisältöön
FrAIFlow

Ratkaisut / Koodaus ja URL-osoitteet

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.

Kaksi eri purkuvirhettä
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

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.

Yhdistä tavut tarkoitettuun tekstiin
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

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.

Yksittäinen prosenttikoodaus ja vanha %92 aiheuttavat URIError-virheen; UTF-8 %E2%80%99 purkautuu oikeaksi yksinkertaiseksi lainausmerkiksi.
Säilytetty alkuperäinen selitys.
Synteettisen testin tallennettu tulos: virheellisen prosenttikoodatun UTF-8:n korjaaminen
Tallennetut Node.js:n decodeURIComponent-tulokset kelvollisille ja virheellisille prosenttikoodatuille syötteille. Kuva esittää tallennettua testitulosta, ei alkuperäisen ilmoittajan sovellusta. Avaa täysikokoinen testikuva.

Lähteet ja lisälukeminen