Vai al contenuto
FrAIFlow

Soluzioni / Codifica e URL

Correggere UTF-8 malformato con codifica percentuale

Un valore URL arriva all’applicazione, ma decodeURIComponent() genera URIError. Prima di sostituire la punteggiatura, distingui due errori: un escape percentuale incompleto e un escape di byte completo ma non valido in UTF-8.

Due errori di decodifica diversi
Illustrazione dell’autore basata sull’esempio conservato; non una schermata dell’applicazione.

Trova il passaggio in cui il valore cambia

Supponi che la casella di ricerca accetti 50% off, ma aprire il collegamento risultante blocchi la pagina. Il segno percentuale è testo normale nella casella. Diventa speciale solo quando il codice lo tratta come un componente URL già codificato. Annota il valore atteso a ogni passaggio: testo dell’utente, URL serializzato e valore letto dal destinatario. Cerchi un’incompatibilità di codifica, non punteggiatura da eliminare.

Usa un campione innocuo invece di copiare veri collegamenti di reimpostazione password o ricerche di clienti in console o segnalazioni pubbliche. Prova prima decodeURIComponent("%25"): il risultato atteso è un solo segno percentuale. Poi prova il campione problematico con la funzione protetta della sezione “Rifiuta l’input malformato senza bloccare la pagina”. Se il controllo valido funziona e il campione no, il decodificatore non è completamente guasto: bisogna indagare i dati forniti.

Distingui un escape incompleto da UTF-8 non valido

Un % isolato non ha il valore di byte a due cifre. Al contrario, %92 è sintatticamente un escape di byte, ma quel byte non può stare da solo in UTF-8. Segnalazioni pubbliche mostrano entrambi gli errori, inclusi vecchi byte per le virgolette e un %AF.

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

Il campione conservato con Node v24.19.0 ha riprodotto questi risultati e ha provato anche %91, %AF e la virgoletta sinistra UTF-8. I messaggi del browser possono differire; la prova utile è se l’esatto input venga accettato o respinto.

Associa i byte al testo previsto
Illustrazione dell’autore basata sull’esempio conservato; non una schermata dell’applicazione.

Costruisci query string senza concatenare escape a mano

Per un nuovo collegamento, passa il testo originale all’API URL e lascia che serializzi il parametro. Sul lato ricevente, leggi il parametro con la stessa API. Non decodificare subito una seconda volta il valore restituito:

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é

È un URL di esempio, non un endpoint FrAIFlow. La distinzione importante è fra componente codificato e valore già interpretato. Un secondo passaggio può trasformare testo perfettamente legittimo come 50% off in un’eccezione. Ricorda anche che il segno più nei parametri di query in stile modulo viene trattato diversamente da un più letterale passato direttamente a decodeURIComponent(); scegli il parser adatto al formato.

Correggi il produttore invece di indovinare i caratteri

Conserva privatamente il campione esatto che fallisce e chiedi al produttore quale codifica abbia usato. Un %92 isolato può suggerire una vecchia convenzione di byte, ma da solo non ne dimostra l’origine. Non sostituirlo silenziosamente con un apostrofo in ID account, firme o nomi file. Restituisci un errore utile, conserva l’input per l’utente e correggi la codifica alla sorgente quando possibile.

Dopo la modifica, prova un percento letterale, una parola accentata, una virgoletta tipografica, un più e una e commerciale. Ogni valore deve restare invariato nel ciclo crea collegamento → apri collegamento → leggi valore. L’input malformato deve produrre un errore controllato senza bloccare il resto della pagina. Questi controlli verificano il contratto del formato, non giustificano decodifiche ripetute finché il testo sembra leggibile.

Rifiuta l’input malformato senza bloccare la pagina

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

Questo controllo segnala il fallimento senza cambiare silenziosamente un identificativo. Non scopre una codifica sorgente sconosciuta. Decodifica solo quante volte richiede il formato: un percento rimasto dopo una decodifica riuscita non giustifica un altro passaggio. Evita il deprecato unescape() come correzione UTF-8 e non inserire token o query private nei registri pubblici.

Un escape percentuale incompleto e il vecchio %92 generano URIError; UTF-8 %E2%80%99 produce una virgoletta singola destra.
Spiegazione originale conservata.
Risultato sintetico registrato: UTF-8 percentuale malformato
Risultati Node.js registrati di decodeURIComponent con input percentuali validi e malformati. È una cattura del test, non l’applicazione del segnalante originale. Apri l’immagine del test a dimensione intera.

Fonti e approfondimenti