URL-codering

Gerelateerde aanbevelingen

Toepassingsgevallen

• API-parameterdebugging: vergelijk uitvoer van encodeURIComponent en encodeURI om problemen met interfacehandtekeningmismatch op te lossen
• Log-decodering: decodeer batchgewijs URL-gecodeerde inhoud in logs om leesbare tekst te herstellen
• URL-bouw: Query Only-modus behoudt sleutelnamen en codeert alleen waarden, om formaatfouten bij handmatige samenvoeging te voorkomen
• Frontend-ontwikkeling: markering helpt begrijpen welke tekens worden ontsnapt, handig voor het debuggen van paginadosering
• Gegevensmigratie: verwerk batchgewijs URL-gecodeerde gegevens uit verouderde systemen om naar nieuw formaat te converteren

Functies

• Vier coderingsmodi: wissel tussen encodeURIComponent / encodeURI / full / RFC 3986 met één klik, vergelijk uitvoerverschillen in realtime
• Coderingsmarkering: markeert ontsnapte %XX-tekens in realtime, amberkleurige markering maakt coderingsresultaten direct zichtbaar
• Batchmodus: ondersteunt meerdere regels batchcodering/decodering, elke regel wordt onafhankelijk verwerkt, ideaal voor logs of bulkgegevens
• Query Only-modus: codeert alleen het parameterwaardegedeelte van de URL (na het is-gelijk-teken), sleutelnamen, tekens en padstructuur blijven intact
• Realtime debounce: codeert/decodeert automatisch binnen 300 ms, geen knoppen nodig, resultaten verschijnen tijdens het typen
• Teken telling: toont het aantal ingevoerde tekens in realtime, handig voor het controleren van API-parameterlengtelimieten

Hoe te gebruiken

1. Voer de URL of tekst in die u wilt coderen/decoderen
2. Kies coderingsrichting (Coderen/Decoderen) en modus (Component / URI / full / RFC 3986)
3. Schakel batchmodus in voor meerregelige gegevens of Query Only voor alleen parameterwaardecodering
4. Controleer het gemarkeerde resultaat en kopieer de gecodeerde tekenreeks voor gebruik in API-aanroepen of URL-bouw

Veelgestelde vragen

Wat is URL-codering?

术语表

Procentcodering (Percent-encoding)

De officiële naam voor URL-codering, een coderingsmethode die tekens weergeeft met % gevolgd door twee hexadecimale cijfers. Bijv. spatie wordt %20, Chinees karakter '中' wordt %E4%B8%AD.Wikipedia - Percent-encoding

encodeURIComponent

JavaScript-ingebouwde functie, codeert alle tekens behalve A-Z a-z 0-9 - _ . ! ~ * ' ( ). Wordt het meest gebruikt voor het coderen van individuele queryparameterwaarden.

encodeURI

JavaScript-ingebouwde functie, behoudt structurele URL-tekens (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) en codeert alleen tekens die daadwerkelijk moeten worden gecodeerd. Gebruikt voor het coderen van volledige URL's.

RFC 3986

De nieuwste IETF-standaard voor URI algemene syntaxis (2005), definieert URL-coderingsregels en classificeert tilde ~ als een niet-gereserveerd teken (geen codering nodig). Vervangt oude RFC 2396 en RFC 1738.RFC 3986

Gereserveerde tekens (Reserved Characters)

Tekens met speciale betekenis in URL's, zoals : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Deze tekens moeten worden gecodeerd wanneer ze als gegevens worden gebruikt, maar niet in hun structurele posities.

Niet-gereserveerde tekens (Unreserved Characters)

Veilige tekens die in elke URL-positie kunnen worden gebruikt zonder codering, inclusief A-Z, a-z, 0-9, -, _, ., ~ (per RFC 3986).

Query String

Het deel van de URL na ?, bestaande uit key=value-paren gescheiden door &. Bijv. in ?name=张三&age=20 zijn name=张三 en age=20 twee parameters.

URLSearchParams

API geleverd door moderne browsers voor het eenvoudig bouwen en parseren van URL-querystrings, met automatische codering en decodering. Veiliger en betrouwbaarder dan handmatige tekenreekssamenvoeging.

application/x-www-form-urlencoded

Het standaard verzendformaat voor HTML-formulieren, waarbij spaties worden gecodeerd als + in plaats van %20, wat enigszins verschilt van encodeURIComponent. Serverframeworks verwerken meestal beide formaten automatisch.

UTF-8-codering

De standaard tekencoderingsmethode voor het web. Bij URL-codering worden niet-ASCII tekens (zoals Chinees, emoji) eerst geconverteerd naar UTF-8-bytereeksen, vervolgens wordt elke byte gecodeerd in %XX-formaat.

Vergelijking van tekens die in 4 coderingsmodi worden ontsnapt

Snelle referentie voor veelvoorkomende gereserveerde URL-tekens

Code Examples

// encodeURIComponent: codeert individuele parameterwaarden (meest gebruikt)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: codeert volledige URL (behoudt structurele tekens :/?#&=)
const url = encodeURI('https://example.com/search?q=hallo wereld');
console.log(url);

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

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

// URLSearchParams API (moderne manier, automatische codering)
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: vergelijkbaar met encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# RFC 3986-modus (~ standaard niet gecodeerd)
print(quote('hello~world'))  # hello~world

# quote_plus: spaties gecodeerd als + (formulierformaat)
print(quote_plus('hello world'))  # hello+world

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

# urlencode: querystring bouwen
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 {
        // URL-codering (URLEncoder - formulierformaat, spaties worden +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

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

        // Volledige URL bouwen (URI-klasse handelt codering automatisch af)
        URI uri = new URI("https", "example.com", "/search", "q=hallo", null);
        System.out.println(uri.toASCIIString());
    }
}

Authoritative References

• ReferenceRFC 3986 - Uniform Resource Identifier (URI): Generic Syntax
• ReferenceRFC 1738 - Uniform Resource Locators (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceWikipedia - Percent-encoding