Codificatore / Decodificatore URL

Un codificatore URL converte i caratteri che non possono essere usati direttamente in un URL in sequenze codificate percentualmente. Un decodificatore URL inverte il processo, trasformando il testo codificato percentualmente nei caratteri originali. Questa pagina fa entrambe le cose, in entrambe le direzioni, per un singolo componente URL o un URL completo.

Lo strumento utilizza le quattro funzioni JavaScript standard:

• encodeURIComponent — per codificare un singolo componente URL, come il valore di un parametro di query.
• encodeURI — per codificare un URL completo preservando i caratteri riservati come : / ? # & = che hanno un significato strutturale.
• decodeURIComponent — per decodificare un singolo componente URL nei caratteri originali.
• decodeURI — per decodificare un URL completo senza toccare i caratteri riservati.

Tutte le conversioni sono compatibili con UTF-8, quindi lettere accentate, emoji e caratteri di script non latini vengono gestiti correttamente. Nulla viene caricato, nulla viene memorizzato e non vengono effettuate chiamate API.

Alcuni esempi pratici di come appare la codifica URL in pratica:

• Uno spazio diventa %20, quindi ciao mondo viene codificato come ciao%20mondo.
• Una barra in un valore di query diventa %2F, quindi a/b diventa a%2Fb come parametro.
• Un punto interrogativo in un valore diventa %3F, quindi cosa? diventa cosa%3F.
• Una e commerciale in un valore diventa %26, evitando di interrompere la stringa di query circostante.
• Un cancelletto in un valore diventa %23, quindi c# diventa c%23.
• I caratteri non ASCII utilizzano sequenze UTF-8 multibyte. Ad esempio caffè diventa caff%C3%A8 (la è rappresenta due byte UTF-8).
• Anche gli emoji usano UTF-8 multibyte: 😀 diventa %F0%9F%98%80.

Imposta lo strumento su Decodifica e incolla una di queste stringhe codificate per vedere il testo originale ripristinato esattamente.

La scelta della modalità corretta è importante perché i due codificatori trattano i caratteri riservati in modo diverso.

Usa la modalità Componente (encodeURIComponent / decodeURIComponent) quando codifichi un singolo valore che verrà inserito in un URL — ad esempio il valore di un parametro di query, un segmento di percorso o un valore di frammento. La modalità Componente codifica percentualmente i caratteri riservati (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) in modo che non possano modificare accidentalmente la struttura dell'URL circostante.

Usa la modalità URL Completo (encodeURI / decodeURI) quando hai un URL completo come https://esempio.it/percorso?query=valore#frammento e vuoi solo eseguire l'escape dei caratteri non sicuri (ad esempio spazi o caratteri non ASCII), senza toccare i caratteri strutturali riservati.

Un errore comune è usare encodeURI su un valore che dovrebbe essere un parametro di query. I caratteri riservati rimangono intatti, il che può corrompere l'URL circostante. In caso di dubbio, codifica ogni valore di query con encodeURIComponent e assembla l'URL in seguito.

La codifica percentuale (chiamata anche codifica URL) è un modo per rappresentare in un URL caratteri riservati (con significato strutturale) o caratteri non consentiti. Ogni byte non sicuro viene scritto come un segno percentuale seguito da due cifre esadecimali — ad esempio %20 per uno spazio, %2F per una barra o %3F per un punto interrogativo.

La codifica opera sui byte, non direttamente sui caratteri. Gli URL moderni usano UTF-8 per convertire prima i caratteri in byte, motivo per cui una singola lettera accentata può diventare due byte codificati percentualmente e un emoji può diventarne quattro. Questo strumento utilizza sempre UTF-8, rendendo le stringhe codificate interoperabili con il resto del web.

La codifica percentuale è definita dall'RFC 3986. Le funzioni JavaScript native qui utilizzate implementano tale specifica, quindi un valore codificato con encodeURIComponent in qualsiasi browser moderno viene decodificato correttamente con decodeURIComponent ovunque.

Questo codificatore decodificatore URL è utile ogni volta che devi spostare testo in modo sicuro all'interno o all'esterno di un URL. Scenari comuni:

• Codificare testo per una stringa di query prima di incollarlo in una richiesta API, in un file di log o nella barra degli indirizzi del browser.
• Decodificare i parametri URL da un log di richieste o da un'esportazione di analisi per leggere i valori originali.
• Ispezionare un URL codificato lungo decodificandolo e verificando cosa viene effettivamente trasmesso.
• Eseguire l'escape di caratteri speciali in un URL prima di condividerlo in una chat, in documentazione o in un payload JSON.
• Imparare come la codifica percentuale e le sequenze di byte UTF-8 si mappano sui caratteri.

Poiché lo strumento viene eseguito interamente nel browser, è adatto anche per URL sensibili (link interni, token, URL firmate) che preferisci non incollare in un servizio remoto.

La codifica URL e la pulizia URL sono due operazioni diverse che vengono spesso confuse.

La codifica URL (questo strumento) trasforma i caratteri in una forma sicura per gli URL tramite codifica percentuale e inverte l'operazione. La struttura dell'URL viene preservata; non viene aggiunto né rimosso nulla.

La pulizia URL (un tipo di strumento separato) rimuove i parametri di tracciamento come utm_source, utm_medium, fbclid, gclid e chiavi di query simili da un URL, in modo che il link risultante non contenga più metadati di tracciamento. La pulizia modifica i parametri nell'URL — la codifica non lo fa.

Se vuoi rimuovere i parametri di tracciamento, hai bisogno di uno strumento dedicato alla pulizia degli URL. Se vuoi codificare o decodificare testo in forma percentuale, questo è lo strumento giusto.