Codificatore e Decodificatore URL con Parser URL Integrato

Cos'è la Codifica URL (Percent-Encoding)?

// Encode a query parameter value
const param = encodeURIComponent('hello world & goodbye');
console.log(param); // → 'hello%20world%20%26%20goodbye'

// Encode a full URL (preserves structure)
const url = encodeURI('https://example.com/path name?q=hello world');
console.log(url); // → 'https://example.com/path%20name?q=hello%20world'

// Decode a percent-encoded string
const decoded = decodeURIComponent('hello%20world%20%26%20goodbye');
console.log(decoded); // → 'hello world & goodbye'

// Build a URL with encoded parameters
const base = 'https://api.example.com/search';
const query = `?q=${encodeURIComponent('你好')}&lang=zh`;
console.log(base + query); // → 'https://api.example.com/search?q=%E4%BD%A0%E5%A5%BD&lang=zh'

Caratteristiche Principali

Esempi

https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dhello%20world%26lang%3Den

https://example.com/search?q=hello world&lang=en

https://example.com/search?q=你好世界

https://example.com/search?q=%E4%BD%A0%E5%A5%BD%E4%B8%96%E7%95%8C

https://example.com/api?name=John Doe&role=admin&lang=en&sort=date desc

https://example.com/api?name=John%20Doe&role=admin&lang=en&sort=date%20desc

https://user:pass@example.com:8080/path/to/page?key=value&arr[]=1#section-2

https://user:pass@example.com:8080/path/to/page?key=value&arr%5B%5D=1#section-2

https://auth.example.com/authorize?redirect_uri=https://myapp.com/callback?code=abc&state=xyz

https://auth.example.com/authorize?redirect_uri=https%3A%2F%2Fmyapp.com%2Fcallback%3Fcode%3Dabc%26state%3Dxyz

Come Usare

1. 1

   Inserisci un URL o una Stringa Codificata

   Incolla un URL nell'area decodificata per codificarlo, oppure incolla una stringa percent-encoded nell'area codificata per decodificarla. Seleziona la modalità encodeURI o encodeURIComponent in base al tuo caso d'uso.

2. 2

   Vedi i Risultati e la Struttura Analizzata

   L'altra area si aggiorna istantaneamente mentre digiti. Il parser URL scompone l'URL in protocollo, host, porta, percorso, parametri di query e frammento — tutto modificabile.

3. 3

   Copia o Ricostruisci

   Clicca Copia per copiare il risultato codificato o decodificato. Modifica i singoli componenti dell'URL e clicca Ricostruisci per costruire un nuovo URL dalle parti modificate.

Errori Comuni

https://example.com/path%2520with%2520spaces

https://example.com/path%20with%20spaces

https://example.com/my+file+name.pdf

https://example.com/my%20file%20name.pdf

encodeURI('key=value&more')  → 'key=value&more' (& not encoded!)

encodeURIComponent('key=value&more')  → 'key%3Dvalue%26more'

Decoding %82%B1%82%F1 as UTF-8 (this is Shift-JIS for こん)

Using UTF-8: %E3%81%93%E3%82%93 correctly decodes to こん

encodeURIComponent('../images/photo.jpg')  → '..%2Fimages%2Fphoto.jpg'

Encode each segment: '../images/' + encodeURIComponent('my photo.jpg')

Casi d'Uso Comuni

Debug di URL Illeggibili

Decodifica URL percent-encoded dai log dei server, dai messaggi di errore o dagli strumenti per sviluppatori del browser per leggere il testo originale leggibile.

Sviluppo API

Codifica i valori dei parametri di query per le chiamate API REST, assicurandoti che caratteri speciali come &, =, e gli spazi non rompano l'URL della richiesta.

Configurazione del Flusso OAuth

Codifica correttamente redirect_uri e altri parametri URL negli URL di autorizzazione OAuth per prevenire fallimenti di autenticazione.

URL Internazionalizzati

Codifica e decodifica URL contenenti caratteri cinesi, giapponesi, coreani, arabi o altri caratteri non ASCII per applicazioni web internazionalizzate.

Analisi di Link di Marketing

Decodifica URL di tracciamento da campagne email e piattaforme pubblicitarie per comprendere i parametri UTM incorporati e le catene di reindirizzamento.

Ispezione della Struttura URL

Analizza URL complessi nelle loro parti componenti — protocollo, host, porta, percorso, parametri di query e frammento — per analisi e modifica.

Dettagli Tecnici

Caratteri Riservati e Non Riservati della RFC 3986

La RFC 3986 definisce i caratteri non riservati (A-Z, a-z, 0-9, -, ., _, ~) che non hanno mai bisogno di codifica, e i caratteri riservati (:, /, ?, #, [, ], @, !, $, &, ', (, ), *, +, ,, ;, =) che fungono da delimitatori URI e devono essere codificati con percent-encoding quando usati come dati.

Flusso di Codifica dei Byte UTF-8

I caratteri non ASCII vengono prima convertiti nel loro code point Unicode, poi codificati come byte UTF-8 (1-4 byte a seconda dell'intervallo del code point), e infine ogni byte viene codificato con percent-encoding come %XX. Per esempio: é (U+00E9) → byte UTF-8 C3 A9 → %C3%A9. L'emoji 🎉 (U+1F389) → byte UTF-8 F0 9F 8E 89 → %F0%9F%8E%89.

Terminologia URL vs URI

Un URI (Uniform Resource Identifier) è il termine generale per qualsiasi stringa identificatrice. Un URL (Uniform Resource Locator) è un URI che specifica anche il meccanismo di accesso (come https://). Le regole di codifica nella RFC 3986 si applicano a tutti gli URI. L'API di JavaScript usa la terminologia URI (encodeURI, decodeURI), mentre l'uso quotidiano preferisce URL.

Migliori Pratiche

Usa la Modalità Giusta per il Compito

Usa encodeURIComponent() per le singole chiavi e i valori dei parametri di query. Usa encodeURI() solo quando hai un URL completo e vuoi codificare i caratteri non sicuri senza romperne la struttura. Non usare mai encodeURI() su valori di parametri che potrebbero contenere &, =, o altri caratteri riservati.

Evita la Doppia Codifica

Prima di codificare una stringa, controlla se è già codificata. Cerca sequenze % esistenti. Codificare una stringa già codificata trasforma %20 in %2520, %3D in %253D, e così via. Se non sei sicuro, decodifica prima, poi codifica una sola volta.

Decodifica sul Lato Server

La maggior parte dei framework web decodifica automaticamente i parametri URL prima che il codice della tua applicazione li veda. Evita di decodificare manualmente parametri che il tuo framework ha già decodificato — questo può causare problemi se il valore originale conteneva sequenze percent letterali.

Codifica i Valori per OAuth e API Signing

Le stringhe base delle firme OAuth 1.0 e molti algoritmi di firma API richiedono un percent-encoding rigoroso secondo la RFC 3986. Usa encodeURIComponent() e poi sostituisci eventuali caratteri rimanenti che non codifica (come !, ', (, ), *) con i loro equivalenti percent-encoded se la specifica lo richiede.

Domande Frequenti