Codificatore e decodificatore percentuale URL

Senza di essa, un termine di ricerca con spazi spezza una query, un oggetto email con accenti corrompe un link mailto e il nome di un prodotto con una barra sembra un nuovo percorso. Scelga la modalità component quando codifica il valore di un singolo parametro, oppure la modalità URI completo quando separatori strutturali come i due punti con barra e il punto interrogativo devono restare intatti.

Come funzionano la codifica percentuale e i due profili URL

La codifica percentuale, definita per il web negli standard URI seguiti dai browser e da RFC 3986, sostituisce ogni byte non ammesso in un dato contesto con un segno di percentuale e due cifre esadecimali. Per il testo UTF-8, i caratteri multi-byte diventano diversi gruppi %HH in sequenza, quindi café diventa caf%C3%A9 e un semplice spazio diventa %20. Due profili comuni contano nel lavoro quotidiano.

Il profilo component corrisponde a encodeURIComponent: protegge quasi tutto ciò che non è un carattere non riservato, inclusi i delimitatori riservati come e commerciale, uguale, punto interrogativo, barra e due punti. È ciò che desidera quando la stringa è il valore di un singolo parametro di query o un singolo segmento di percorso che non deve essere scambiato per struttura. Il profilo URI completo corrisponde a encodeURI: protegge comunque spazi e non ASCII, ma lascia intatta la punteggiatura strutturale affinché un intero indirizzo come https://example.com/path?

La decodifica inverte la mappa. Prima dell'esecuzione della decodifica dell'host, questa capacità scansiona l'input alla ricerca di escape ben formati: ogni segno di percentuale deve essere seguito da esattamente due cifre esadecimali. Quel controllo rigoroso è intenzionale; un'accettazione silenziosa nasconderebbe errori di incollaggio e produrrebbe risultati diversi tra linguaggi che non concordano su come trattare gli escape rotti.

Che cosa invia e che cosa riceve

Invii un campo stringa obbligatorio chiamato text e i campi opzionali mode e component. La modalità encode protegge il testo in percentuale secondo il profilo selezionato e restituisce la stringa trasformata in result. La modalità decode convalida ogni sequenza percentuale, poi inverte la codifica e restituisce testo UTF-8 semplice in result.

Component è predefinito a true per il rigoroso profilo component; lo imposti su false per il profilo URI completo che preserva i delimitatori strutturali. La risposta riporta mode, component, il text originale, result, la lunghezza di result, una breve etichetta di profilo component o uri e un'etichetta standard che nomina le funzioni JavaScript incorporate corrispondenti, affinché i client possano verificare quale contratto hanno raggiunto. I fallimenti di convalida non consumano saldo prepagato.

Dove la codifica percentuale URL appare nel lavoro reale

I servizi backend che assemblano destinazioni di reindirizzamento, URL di callback OAuth e percorsi di ritorno firmati devono codificare ogni valore di parametro indipendentemente affinché una e commerciale nel titolo di un prodotto non possa inventare un secondo campo di query. Le app frontend che costruiscono link di ricerca e filtro da caselle di testo libero necessitano della codifica component su ogni valore lasciando intatto il modello di percorso.

I modelli di email ed SMS che incorporano deep link con nomi utente, tag di campagna o oggetti Unicode si affidano alla codifica percentuale affinché operatori e client non riformattino o corrompano l'href. I team di supporto incollano stringhe semi-codificate dai ticket e necessitano di un percorso di decodifica che fallisca rumorosamente su escape % troncati invece di inventare caratteri. Gli ingegneri di localizzazione verificano che le lingue multi-byte completino il ciclo di codifica e decodifica senza mojibake.

Gli autori di programmi didattici che insegnano le basi del web desiderano una pagina dedicata alla codifica percentuale con entrambi i profili component e URI completo invece di seppellire l'argomento sotto un generico strumento Base64 o slug, perché l'intento di ricerca e le regole dei caratteri riservati differiscono. Se Le servono Base64, Base32, generazione di slug, assemblaggio UTM o convalida completa della struttura degli URL, li tratti come intenti di ricerca e pagine separati invece di sovraccaricare questa pagina del codificatore percentuale.