Codifica URL

Raccomandazioni correlate

Cos'è la codifica URL?

Casi d'uso

• Debug parametri API: confronta gli output di encodeURIComponent e encodeURI per risolvere problemi di mancata corrispondenza della firma dell'interfaccia
• Decodifica log: decodifica in batch il contenuto codificato URL nei log per ripristinare testo leggibile
• Costruzione URL: la modalità Query Only preserva i nomi delle chiavi e codifica solo i valori, evitando errori di formato dovuti alla concatenazione manuale
• Sviluppo frontend: l'evidenziazione aiuta a capire quali caratteri vengono escapati, utile per eseguire il debug dei reindirizzamenti di pagina
• Migrazione dati: elabora in batch dati codificati URL esportati da sistemi legacy per convertirli al nuovo formato

Come utilizzare

1. Inserisci o incolla l'URL o il testo da codificare/decodificare
2. Seleziona la direzione di codifica (Codifica/Decodifica) e la modalità (Component / URI / full / RFC 3986)
3. Attiva la modalità batch per dati multilinea, o Query Only per codificare solo i valori dei parametri
4. Verifica il risultato evidenziato e copia la stringa codificata per l'uso nelle richieste API o nella costruzione di URL

Funzionalità

• Quattro modalità di codifica: passaggio con un clic tra encodeURIComponent / encodeURI / full / RFC 3986, confronto in tempo reale delle differenze di output
• Evidenziazione codifica: evidenzia in tempo reale i caratteri %XX escapati, marcatura color ambra per visualizzare i risultati della codifica a colpo d'occhio
• Modalità batch: supporto per codifica/decodifica multilinea in batch, ogni riga viene elaborata indipendentemente, ideale per log o dati in blocco
• Modalità Query Only: codifica solo la parte del valore del parametro URL (dopo il segno di uguale), mantenendo intatti i nomi delle chiavi, i simboli e la struttura del percorso
• Debounce in tempo reale: codifica/decodifica automatica in 300ms, nessun clic su pulsanti necessario, i risultati appaiono durante la digitazione
• Conteggio caratteri: visualizza in tempo reale il numero di caratteri inseriti, pratico per verificare i limiti di lunghezza dei parametri API

Esempi di codice

// encodeURIComponent: codifica valori di parametri singoli (più comune)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: codifica URL completa (preserva caratteri strutturali :/?#&=)
const url = encodeURI('https://example.com/search?q=ciao mondo');
console.log(url);

// Decodifica
const decoded = decodeURIComponent(param);
console.log(decoded); // 张三&李四

// Conforme RFC 3986 (~ non codificato)
function rfc3986Encode(str) {
  return encodeURIComponent(str).replace(/[!'()*]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase());
}

// API URLSearchParams (metodo moderno, codifica automatica)
const params = new URLSearchParams({ name: '张三', city: '北京' });
console.log(params.toString());
// name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

from urllib.parse import quote, unquote, urlencode, quote_plus

# quote: simile a encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# Modalità RFC 3986 (~ non codificato, è l'impostazione predefinita)
print(quote('hello~world'))  # hello~world

# quote_plus: gli spazi sono codificati come + (formato modulo)
print(quote_plus('hello world'))  # hello+world

# Decodifica
print(unquote(encoded))  # 张三&李四

# urlencode: costruisci query string
params = urlencode({'name': '张三', 'city': '北京'})
print(params)
# name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

import java.net.URLEncoder;
import java.net.URLDecoder;
import java.net.URI;
import java.nio.charset.StandardCharsets;

public class URLEncodeExample {
    public static void main(String[] args) throws Exception {
        // Codifica URL (URLEncoder è formato modulo, spazi diventano +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

        // Decodifica
        String decoded = URLDecoder.decode(encoded, "UTF-8");
        System.out.println(decoded); // 张三&李四

        // Costruisci URL completa (la classe URI gestisce automaticamente la codifica)
        URI uri = new URI("https", "example.com", "/search", "q=ciao", null);
        System.out.println(uri.toASCIIString());
    }
}

Domande frequenti

Glossario

Codifica percentuale (Percent-encoding)

Il nome ufficiale della codifica URL, un metodo di codifica che rappresenta i caratteri utilizzando % seguito da due cifre esadecimali. Ad esempio, lo spazio è codificato come %20, il carattere cinese '中' come %E4%B8%AD.Wikipedia - Codifica percentuale

encodeURIComponent

Funzione integrata di JavaScript che codifica tutti i caratteri tranne A-Z a-z 0-9 - _ . ! ~ * ' ( ). È più comunemente usata per codificare valori individuali di parametri di query URL.

encodeURI

Funzione integrata di JavaScript che preserva i caratteri strutturali dell'URL (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) e codifica solo i caratteri che necessitano realmente di codifica. È usata per codificare URL completi.

RFC 3986

L'ultimo standard IETF per la sintassi generica URI (2005), che definisce le regole di codifica URL e classifica la tilde ~ come carattere non riservato (non richiede codifica). Sostituisce i precedenti RFC 2396 e RFC 1738.RFC 3986

Caratteri riservati (Reserved Characters)

Caratteri con significato speciale negli URL, come : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Questi caratteri devono essere codificati quando usati come dati, ma non nelle loro posizioni strutturali.

Caratteri non riservati (Unreserved Characters)

Caratteri sicuri che possono essere utilizzati in qualsiasi posizione nell'URL senza codifica, inclusi A-Z, a-z, 0-9, -, _, ., ~ (secondo RFC 3986).

Query String

La parte dell'URL dopo ?, composta da coppie key=value separate da &. Ad esempio, in ?name=张三&age=20, name=张三 e age=20 sono due parametri.

URLSearchParams

API fornita dai browser moderni per costruire e analizzare facilmente le query string URL, con gestione automatica di codifica e decodifica. Più sicura e affidabile della concatenazione manuale di stringhe.

application/x-www-form-urlencoded

Il formato di invio predefinito dei moduli HTML, dove gli spazi sono codificati come + invece di %20, leggermente diverso da encodeURIComponent. I framework lato server di solito gestiscono automaticamente entrambi i formati.

Codifica UTF-8

La codifica dei caratteri standard del Web. Nella codifica URL, i caratteri non ASCII (come cinese, emoji) vengono prima convertiti in sequenze di byte UTF-8, quindi ogni byte viene codificato nel formato %XX.

Confronto escape caratteri in 4 modalità di codifica

Riferimento rapido caratteri riservati URL comuni

Authoritative References

• ReferenceRFC 3986 - Identificatore Uniforme di Risorsa (URI): Sintassi Generica
• ReferenceRFC 1738 - Localizzatori Uniformi di Risorse (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceWikipedia - Codifica percentuale