Ga naar de inhoud
FrAIFlow

Oplossingen / Codering en URL's

Herstel ongeldige procentgecodeerde UTF-8

Een URL-waarde bereikt je app, maar decodeURIComponent() geeft URIError. Onderscheid vóór het vervangen van leestekens twee fouten: een onvolledige procentescape en een volledige byte-escape die geen geldige UTF-8 vormt.

Twee verschillende decodeerfouten
Uitleg gemaakt door de auteur op basis van het bewaarde voorbeeld; geen schermafbeelding van een toepassing.

Zoek de overgang waar de waarde verandert

Stel dat een zoekvak 50% off accepteert, maar de resulterende link de pagina laat vastlopen. Het procentteken is gewone tekst in het zoekvak. Het krijgt pas een bijzondere betekenis wanneer code die tekst als een al gecodeerd URL-onderdeel behandelt. Noteer de verwachte waarde bij elke overgang: de gebruikersinvoer, de geserialiseerde URL en de waarde die de ontvangende pagina leest. Je zoekt een coderingsverschil, niet naar leestekens die weg moeten.

Gebruik een onschuldig voorbeeld in plaats van een echte wachtwoordherstellink of klantzoekopdracht naar een console of openbaar issue te kopiëren. Probeer eerst decodeURIComponent("%25"): het verwachte resultaat is één procentteken. Probeer daarna de foutgevende invoer met de afgeschermde functie onder ‘Ongeldige invoer weigeren zonder de pagina te laten vastlopen’. Werkt de geldige controle wel en het voorbeeld niet, dan is de decoder niet in het algemeen defect; controleer dan de aangeleverde gegevens.

Onderscheid een kapotte escape van ongeldige UTF-8

Een losse % heeft geen bytewaarde van twee cijfers. Daarentegen is %92 syntactisch wel een byte-escape, maar die byte kan niet zelfstandig in UTF-8 staan. Openbare meldingen tonen beide fouten, waaronder oude aanhalingstekenbytes en een geïsoleerde %AF.

decodeURIComponent("%");          // URIError
 decodeURIComponent("%92");        // URIError
 decodeURIComponent("%25");        // %
 decodeURIComponent("%C2%AF");     // ¯
 decodeURIComponent("%E2%80%99"); // ’

Het bewaarde Node v24.19.0-testvoorbeeld reproduceerde deze uitkomsten en testte ook %91, %AF en het linker aanhalingsteken in UTF-8. De browser kan een andere fouttekst tonen; slagen of weigeren van exact dezelfde invoer is het bruikbare bewijs.

Laat bytes overeenkomen met de bedoelde tekst
Uitleg gemaakt door de auteur op basis van het bewaarde voorbeeld; geen schermafbeelding van een toepassing.

Bouw querystrings zonder procentescapes handmatig aaneen te plakken

Geef voor een nieuwe link de oorspronkelijke tekst aan de URL-API en laat die de parameter serialiseren. Lees de parameter aan de ontvangende kant via dezelfde API. Decodeer de teruggegeven waarde niet meteen nogmaals:

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é

Dit is een voorbeeld-URL, geen FrAIFlow-endpoint. Het gaat om het verschil tussen een gecodeerd onderdeel en een waarde die al is geparst. Een tweede decodeerronde kan volkomen geldige tekst zoals 50% off in een uitzondering veranderen. Houd er ook rekening mee dat een plusteken in formulierachtige queryparameters anders wordt behandeld dan een letterlijke plus die rechtstreeks aan decodeURIComponent() wordt doorgegeven; gebruik de parser die bij het formaat hoort.

Herstel de code die de URL maakt, in plaats van tekens te raden

Bewaar het exacte foutvoorbeeld privé en vraag de producent welke tekencodering is gebruikt. Een losse %92 kan wijzen op een oude byteconventie, maar de byte alleen bewijst de herkomst niet. Vervang deze niet stilzwijgend door een apostrof in account-ID's, handtekeningen of bestandsnamen. Geef een bruikbare foutmelding, bewaar de oorspronkelijke invoer voor de gebruiker en corrigeer zo mogelijk de codering bij de bron.

Test na de wijziging een letterlijk procentteken, een woord met accent, een gekruld aanhalingsteken, een plus en een ampersand. Elke waarde moet de volledige cyclus link maken → link openen → waarde lezen onveranderd doorlopen. Ongeldige invoer moet je gecontroleerde fout geven, niet de rest van de pagina stilleggen. Deze controles toetsen de formaatafspraak; ze rechtvaardigen niet steeds opnieuw decoderen totdat tekst leesbaar lijkt.

Ongeldige invoer weigeren zonder de pagina te laten vastlopen

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" };
  }
}

Deze hulpfunctie geeft een foutmelding zonder een identificatiecode stilzwijgend te veranderen. Ze kan niet achterhalen welke onbekende codering de bron heeft gebruikt. Decodeer alleen zo vaak als de formaatafspraak vereist: een overgebleven procentteken na geslaagd decoderen rechtvaardigt geen volgende ronde. Vermijd het verouderde unescape() als UTF-8-oplossing en houd tokens en privéquerywaarden uit openbare diagnostische logs.

Een losse procentescape en de oude %92 geven beide URIError; UTF-8 %E2%80%99 wordt een rechts enkel aanhalingsteken.
Bewaarde oorspronkelijke uitleg.
Geregistreerde synthetische testuitvoer bij Herstel ongeldige procentgecodeerde UTF-8
Geregistreerde Node.js-resultaten van decodeURIComponent voor geldige en ongeldige procentgecodeerde invoer. Dit is een vastlegging van testuitvoer, niet de toepassing van de oorspronkelijke melder. De bewijsafbeelding op volledige grootte openen.

Bronnen en verwante artikelen