CKTIS / JavaScript
encodeURIComponent — kodowanie składnika URI
encodeURIComponent koduje pojedynczy składnik URI, np. wartość parametru zapytania. Zamienia znaki specjalne i znaki spoza ASCII na sekwencje procentowe reprezentujące bajty UTF-8.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) jest globalną funkcją ECMAScript, a nie interfejsem dostępnym wyłącznie w przeglądarce. Konwertuje argument na tekst i zwraca zakodowany tekst. Używaj jej dla pojedynczej wartości, nie całego adresu.
Pozostawia bez zmian litery A–Z, a–z, cyfry 0–9 oraz - _ . ! ~ * ' ( ). Pozostałe znaki koduje jako bajty UTF-8 zapisane w postaci %HH. Spacja staje się %20, nie +; sam + staje się %2B.
W przeciwieństwie do encodeURI koduje również separatory, takie jak &, =, /, ? i #. Po zakodowaniu te znaki nie pełnią funkcji separatorów podczas składania URI. Funkcja pozostawia jednak bez zmian m.in. apostrofy i nawiasy, które nadal mogą pełnić funkcję separatorów w konkretnej składni URI, np. w adresach URL OData. Nie jest to jednak kodowanie HTML ani walidacja adresu. Ponowne kodowanie wyniku zmienia % na %25.
decodeURIComponent odwraca kodowanie poprawnych danych. Niesparowany surogat UTF-16 w argumencie encodeURIComponent powoduje URIError; funkcja nie zastępuje go automatycznie. Przykład pokazuje kodowanie znaku Unicode, spacji i separatorów oraz sprawdzenie odwracalności.
Przykłady
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Wynik
%C5%BC%20%26%2B%2F true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.