Koder / Dekoder URL

Koder URL zamienia znaki, które nie mogą być używane bezpośrednio w adresie URL, na sekwencje zakodowane procentowo. Dekoder URL odwraca ten proces, przekształcając tekst zakodowany procentowo z powrotem w oryginalne znaki. Ta strona robi obie operacje, w obu kierunkach, zarówno dla pojedynczego komponentu URL, jak i pełnego adresu URL.

Narzędzie używa czterech standardowych funkcji JavaScript:

• encodeURIComponent — do kodowania pojedynczego komponentu URL, np. wartości parametru zapytania.
• encodeURI — do kodowania pełnego adresu URL przy zachowaniu znaków zarezerwowanych jak : / ? # & = mających znaczenie strukturalne.
• decodeURIComponent — do dekodowania pojedynczego komponentu URL z powrotem do oryginalnych znaków.
• decodeURI — do dekodowania pełnego adresu URL bez dotykania znaków zarezerwowanych.

Wszystkie konwersje są zgodne z UTF-8, dzięki czemu litery akcentowane, emoji i znaki z niełacińskich systemów pisma są przetwarzane poprawnie. Nic nie jest przesyłane, nic nie jest przechowywane i nie są wykonywane żadne wywołania API.

Kilka praktycznych przykładów tego, jak kodowanie URL wygląda w praktyce:

• Spacja staje się %20, więc witaj świecie jest kodowane jako witaj%20%C5%9Bwiecie.
• Ukośnik w wartości zapytania staje się %2F, więc a/b staje się a%2Fb jako parametr.
• Znak zapytania w wartości staje się %3F, więc co? staje się co%3F.
• Ampersand w wartości staje się %26, co zapobiega zepsuciu otaczającego ciągu zapytania.
• Znak hash w wartości staje się %23, więc c# staje się c%23.
• Znaki spoza ASCII używają wielobajtowych sekwencji UTF-8. Na przykład café staje się caf%C3%A9 (é to dwa bajty UTF-8).
• Emoji też używają wielobajtowego UTF-8: 😀 staje się %F0%9F%98%80.

Przełącz narzędzie na Dekoduj i wklej któryś z tych zakodowanych ciągów, aby zobaczyć oryginalny tekst dokładnie przywrócony.

Wybór właściwego trybu jest ważny, ponieważ oba kodery inaczej traktują znaki zarezerwowane.

Użyj trybu Komponent (encodeURIComponent / decodeURIComponent) gdy kodujesz pojedynczą wartość, która zostanie wstawiona do adresu URL — na przykład wartość parametru zapytania, segment ścieżki lub wartość fragmentu. Tryb Komponent koduje procentowo znaki zarezerwowane (: / ? # [ ] @ ! $ & ' ( ) * + , ; =), tak aby nie mogły przypadkowo zmienić struktury otaczającego adresu URL.

Użyj trybu Pełny URL (encodeURI / decodeURI) gdy masz kompletny adres URL jak https://przyklad.pl/sciezka?zapytanie=wartosc#fragment i chcesz tylko zamienić niebezpieczne znaki (np. spacje lub znaki spoza ASCII), bez dotykania strukturalnych znaków zarezerwowanych.

Częstym błędem jest użycie encodeURI na wartości, która ma być parametrem zapytania. Zarezerwowane znaki pozostają niezmienione, co może uszkodzić otaczający adres URL. W razie wątpliwości koduj każdą wartość zapytania za pomocą encodeURIComponent, a następnie konstruuj adres URL.

Kodowanie procentowe (zwane też kodowaniem URL) to sposób reprezentowania w adresie URL znaków zarezerwowanych (mających znaczenie strukturalne) lub w ogóle niedozwolonych. Każdy niebezpieczny bajt jest zapisywany jako znak procenta po którym następują dwie cyfry szesnastkowe — na przykład %20 dla spacji, %2F dla ukośnika lub %3F dla znaku zapytania.

Kodowanie działa na bajtach, nie bezpośrednio na znakach. Nowoczesne adresy URL używają UTF-8 do konwersji znaków na bajty, dlatego pojedyncza litera akcentowana może stać się dwoma bajtami zakodowanymi procentowo, a emoji może stać się czterema. Narzędzie zawsze używa UTF-8, dzięki czemu zakodowane ciągi są interoperacyjne z resztą sieci.

Kodowanie procentowe jest zdefiniowane przez RFC 3986. Natywne funkcje JavaScript używane tutaj implementują tę specyfikację, więc wartość zakodowana za pomocą encodeURIComponent w dowolnej nowoczesnej przeglądarce jest poprawnie dekodowana za pomocą decodeURIComponent wszędzie indziej.

Ten koder-dekoder URL jest przydatny zawsze, gdy musisz bezpiecznie przenieść tekst do lub z adresu URL. Typowe zastosowania:

• Kodowanie tekstu dla ciągu zapytania przed wklejeniem go do żądania API, wpisu w logu lub paska adresu przeglądarki.
• Dekodowanie parametrów URL z logu żądań lub eksportu analitycznego, aby odczytać oryginalne wartości.
• Sprawdzanie długiego zakodowanego adresu URL przez jego dekodowanie i sprawdzenie, co faktycznie jest przekazywane.
• Zamiana znaków specjalnych w adresie URL przed udostępnieniem go w czacie, dokumentacji lub payload JSON.
• Nauka jak kodowanie procentowe i sekwencje bajtów UTF-8 odpowiadają znakom.

Ponieważ narzędzie działa całkowicie w przeglądarce, nadaje się też do wrażliwych adresów URL (wewnętrzne linki, tokeny, podpisane adresy URL), których nie chcesz wklejać do zewnętrznego serwisu.

Kodowanie URL i czyszczenie URL to dwie różne operacje, które są często mylone.

Kodowanie URL (to narzędzie) przekształca znaki w bezpieczną dla URL formę procentową i odwraca tę operację. Struktura adresu URL jest zachowywana; nic nie jest dodawane ani usuwane.

Czyszczenie URL (oddzielny rodzaj narzędzia) usuwa parametry śledzenia takie jak utm_source, utm_medium, fbclid, gclid i podobne klucze zapytań z adresu URL, dzięki czemu wynikowy link nie zawiera już metadanych śledzenia. Czyszczenie zmienia parametry w adresie URL — kodowanie nie.

Jeśli chcesz usunąć parametry śledzenia, potrzebujesz dedykowanego czyszczenia URL. Jeśli chcesz kodować lub dekodować tekst w formie procentowej, to jest właściwe narzędzie.