Spring til indholdet
FrAIFlow

Løsninger / Tegnkodning og URL'er

Ret fejlformet procentkodet UTF-8

En URL-værdi når frem til dit program, men decodeURIComponent() udløser URIError. Før du udskifter tegnsætning, skal du skelne mellem to fejl: en ufuldstændig procentsekvens og en fuldstændig bytesekvens, som ikke er gyldig UTF-8.

To forskellige afkodningsfejl
Forklaring fremstillet af forfatteren ud fra det bevarede eksempel; ikke et skærmbillede fra et program.

Find den overgang, hvor værdien ændrer sig

Forestil dig, at et søgefelt accepterer 50% off, men at åbning af det resulterende link får siden til at fejle. Procenttegnet er almindelig tekst i søgefeltet. Det bliver først særligt, når kode behandler teksten som en allerede kodet URL-komponent. Notér den forventede værdi ved hver overgang: brugerens tekst, den serialiserede URL og den værdi, modtagersiden læser. Du leder efter en kodningsuoverensstemmelse, ikke tegnsætning, der skal slettes.

Brug et harmløst eksempel i stedet for at kopiere et rigtigt link til nulstilling af adgangskode eller en kundeforespørgsel til en konsol eller et offentligt issue. Prøv først decodeURIComponent("%25"): Det forventede resultat er ét procenttegn. Prøv derefter det fejlende eksempel med den beskyttede hjælpefunktion i “Afvis fejlformet input uden at få siden til at fejle” nedenfor. Hvis det gyldige kontrolinput virker, mens eksemplet fejler, er dekoderen ikke generelt defekt; de leverede data skal undersøges.

Skeln mellem en brudt procentsekvens og ugyldig UTF-8

Et enkeltstående % har ingen tocifret byteværdi. Derimod er %92 syntaktisk en procentkodet byte, men den byte kan ikke stå alene i UTF-8. Offentlige rapporter viser begge fejl, herunder ældre bytekoder for anførselstegn og et isoleret %AF.

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

Det bevarede Node v24.19.0-testmateriale genskabte resultaterne og testede også %91, %AF og UTF-8-venstreanførselstegnet. Browserens formulering kan variere; succes eller afvisning af det nøjagtige input er den nyttige dokumentation.

Afstem bytes med den tilsigtede tekst
Forklaring fremstillet af forfatteren ud fra det bevarede eksempel; ikke et skærmbillede fra et program.

Byg query-strenge uden at sammenkæde procentsekvenser manuelt

Til et nyt link skal du give originalteksten til URL-API'et og lade det serialisere parameteren. På modtagersiden skal parameteren læses gennem samme API. Afkod ikke straks den returnerede værdi igen:

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é

Dette er en eksempel-URL, ikke et FrAIFlow-endpoint. Den vigtige forskel er mellem en kodet komponent og en værdi, der allerede er parset. En anden afkodning kan gøre helt legitim tekst som 50% off til en undtagelse. Husk også, at et plustegn i query-parametre med formularformat håndteres anderledes end et bogstaveligt plus givet direkte til decodeURIComponent(); brug en parser, der passer til formatet.

Ret afsenderen i stedet for at gætte tegn

Behold det præcise fejlende eksempel privat, og spørg afsenderen, hvilken tegnkodning der blev brugt. Et enkeltstående %92 kan pege på en ældre bytekonvention, men byten alene fastslår ikke oprindelsen. Erstat ikke ubemærket med en apostrof i konto-ID'er, signaturer eller filnavne. Returnér en nyttig fejl, bevar originalinputtet til brugeren, og ret kodningen ved kilden, når det er muligt.

Efter ændringen skal du teste et bogstaveligt procenttegn, et ord med accent, et typografisk anførselstegn, et plus og et og-tegn. Hver værdi skal overleve et helt forløb fra opret link → åbn link → læs værdi uændret. Fejlformet input skal give din kontrollerede fejl frem for at stoppe resten af siden. Kontrollerne verificerer formataftalen; de retfærdiggør ikke gentagen afkodning, indtil strengen ser læsbar ud.

Afvis fejlformet input uden at få siden til at fejle

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

Denne grænse rapporterer fejl uden ubemærket at ændre et ID. Den kan ikke opdage en ukendt kildekodning. Afkod kun så mange gange, som formataftalen kræver: Et procenttegn, der er tilbage efter en vellykket afkodning, begrunder ikke endnu et gennemløb. Undgå det forældede unescape() som UTF-8-løsning, og hold tokens eller private query-værdier væk fra offentlige diagnoselogge.

En enkeltstående procentsekvens og den ældre %92 udløser begge URIError; UTF-8 %E2%80%99 afkodes til et højre enkeltanførselstegn.
Bevaret oprindelig forklaring.
Registreret syntetisk testoutput for rettelse af fejlformet procentkodet UTF-8
Registrerede Node.js decodeURIComponent-resultater for gyldige og fejlformede procentkodede input. Dette er et billede af registreret testoutput, ikke fejlrapportørens oprindelige program. Åbn dokumentationsbilledet i fuld størrelse.

Kilder og relateret læsning