Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła