URL-Kodierung

Ähnliche Tools

Was ist URL-Kodierung?

Anwendungsfälle

• API-Parameter-Debugging: Vergleicht die Ausgaben von encodeURIComponent und encodeURI, um Probleme mit nicht übereinstimmenden Schnittstellensignaturen zu beheben
• Log-Dekodierung: Dekodiert URL-kodierte Inhalte in Logs stapelweise, um lesbaren Text wiederherzustellen
• URL-Erstellung: Query-Only-Modus behält Schlüsselnamen bei und kodiert nur Werte, vermeidet Formatfehler durch manuelle Verkettung
• Frontend-Entwicklung: Hervorhebung hilft zu verstehen, welche Zeichen escapet werden, nützlich zum Debuggen von Seitenumleitungen
• Datenmigration: Verarbeitet stapelweise URL-kodierte Daten aus Altsystemen zur Konvertierung in neue Formate

Anleitung

1. Geben Sie die zu kodierende/dekodierende URL oder den Text ein oder fügen Sie ihn ein
2. Wählen Sie die Kodierungsrichtung (Kodieren/Dekodieren) und den Modus (Component / URI / full / RFC 3986)
3. Aktivieren Sie den Batch-Modus für mehrzeilige Daten oder Query Only, um nur Parameterwerte zu kodieren
4. Überprüfen Sie das hervorgehobene Ergebnis und kopieren Sie die kodierte Zeichenfolge für API-Anfragen oder URL-Erstellung

Funktionen

• Vier Kodierungsmodi: Ein-Klick-Umschaltung zwischen encodeURIComponent / encodeURI / full / RFC 3986, Echtzeitvergleich der Ausgabenunterschiede
• Kodierungshervorhebung: Hebt escapte %XX-Zeichen in Echtzeit hervor, bernsteinfarbene Markierung macht Kodierungsergebnisse auf einen Blick sichtbar
• Batch-Modus: Unterstützt mehrzeilige Batch-Kodierung/-Dekodierung, jede Zeile wird unabhängig verarbeitet, ideal für Logs oder Massendaten
• Query-Only-Modus: Kodiert nur den Parameterwertteil (nach dem Gleichheitszeichen), behält Schlüsselnamen, Symbole und Pfadstruktur unverändert bei
• Echtzeit-Debounce: Automatische Kodierung/Dekodierung nach 300ms, keine Schaltflächenklicks erforderlich, Ergebnisse erscheinen bei der Eingabe
• Zeichenzählung: Zeigt in Echtzeit die Anzahl der eingegebenen Zeichen an, praktisch zur Überprüfung von API-Parameterlängenbegrenzungen

Codebeispiele

// encodeURIComponent: Kodiert einzelne Parameterwerte (am häufigsten verwendet)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: Kodiert vollständige URL (erhält Strukturzeichen :/?#&=)
const url = encodeURI('https://example.com/search?q=hallo welt');
console.log(url);

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

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

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

# RFC 3986-Modus (~ wird nicht kodiert, ist Standard)
print(quote('hello~world'))  # hello~world

# quote_plus: Leerzeichen werden als + kodiert (Formularformat)
print(quote_plus('hello world'))  # hello+world

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

# urlencode: Abfragezeichenfolge erstellen
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-Kodierung (URLEncoder ist Formularformat, Leerzeichen werden zu +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

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

        // Vollständige URL erstellen (URI-Klasse übernimmt automatische Kodierung)
        URI uri = new URI("https", "example.com", "/search", "q=hallo", null);
        System.out.println(uri.toASCIIString());
    }
}

Häufig gestellte Fragen

Glossar

Prozentkodierung (Percent-encoding)

Der offizielle Name der URL-Kodierung, ein Kodierungsverfahren, das Zeichen durch % gefolgt von zwei Hexadezimalziffern darstellt. Beispielsweise wird ein Leerzeichen als %20 kodiert, das chinesische Zeichen „中“ als %E4%B8%AD.Wikipedia - Prozentkodierung

encodeURIComponent

JavaScript-Eingabefunktion, die alle Zeichen außer A-Z a-z 0-9 - _ . ! ~ * ' ( ) kodiert. Wird am häufigsten zur Kodierung einzelner Werte von URL-Abfrageparametern verwendet.

encodeURI

JavaScript-Eingabefunktion, die URL-Strukturzeichen (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) beibehält und nur die Zeichen kodiert, die wirklich kodiert werden müssen. Wird zur Kodierung vollständiger URLs verwendet.

RFC 3986

Der aktuelle IETF-Standard für die generische URI-Syntax (2005), der die Regeln für die URL-Kodierung definiert und die Tilde ~ als nicht reserviertes Zeichen klassifiziert (keine Kodierung erforderlich). Ersetzt die älteren RFC 2396 und RFC 1738.RFC 3986

Reservierte Zeichen (Reserved Characters)

Zeichen mit besonderer Bedeutung in URLs wie : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Diese Zeichen müssen kodiert werden, wenn sie als Daten verwendet werden, aber nicht in ihren strukturellen Positionen.

Nicht reservierte Zeichen (Unreserved Characters)

Sichere Zeichen, die an jeder Position in einer URL ohne Kodierung verwendet werden können, einschließlich A-Z, a-z, 0-9, -, _, ., ~ (gemäß RFC 3986).

Abfragezeichenfolge (Query String)

Der Teil der URL nach ?, bestehend aus key=value-Paaren getrennt durch &. Beispielsweise sind in ?name=张三&age=20 name=张三 und age=20 zwei Parameter.

URLSearchParams

Von modernen Browsern bereitgestellte API zum einfachen Erstellen und Analysieren von URL-Abfragezeichenfolgen mit automatischer Kodierung und Dekodierung. Sicherer und zuverlässiger als manuelle Zeichenfolgenverkettung.

application/x-www-form-urlencoded

Das Standard-Sendeformat von HTML-Formularen, bei dem Leerzeichen als + statt %20 kodiert werden, geringfügig anders als encodeURIComponent. Serverseitige Frameworks verarbeiten normalerweise beide Formate automatisch.

UTF-8-Kodierung

Die Web-Standard-Zeichenkodierung. Bei der URL-Kodierung werden Nicht-ASCII-Zeichen (wie Chinesisch, Emoji) zuerst in UTF-8-Byte-Sequenzen konvertiert, dann wird jedes Byte im Format %XX kodiert.

Vergleich der Zeichen-Escapes in 4 Kodierungsmodi

Schnellreferenz häufiger URL-Reservezeichen

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 - Prozentkodierung