Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

encodeURI() — kodowanie całego URI

encodeURI() koduje znaki całego URI, pozostawiając niektóre separatory bez zmian. Zwraca nowy napis z kodowaniem procentowym UTF-8; nie służy do kodowania pojedynczych wartości parametrów.

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

encodeURI(uri)

encodeURI(uri) to globalna funkcja ECMAScript, a nie API przeglądarki. Konwertuje argument na napis i zwraca nowy napis, zastępując wybrane znaki sekwencjami %HH odpowiadającymi bajtom UTF-8. Spacja staje się %20, nie +.

Bez zmian pozostawia litery ASCII, cyfry oraz -_.!~*'();/?:@&=+$,#. Znaki &, = i # zachowują więc swoje specjalne znaczenie, ale funkcja nie zachowuje struktury każdego poprawnego URI. Na przykład koduje nawiasy kwadratowe wokół literału IPv6: z http://[::1]/ powstaje http://%5B::1%5D/, czyli adres URL z nieprawidłowym hostem. Do kodowania pojedynczej wartości parametru używaj encodeURIComponent(), które koduje również &, = i #.

Jeśli używasz encodeURIComponent() do kodowania pojedynczego segmentu ścieżki, odrzuć wartości równe dokładnie . lub .. przed kodowaniem. Funkcja pozostawia je bez zmian, więc parser URL może potraktować je jako segmenty kropkowe i znormalizować ścieżkę, zamiast zachować je jako dane. Segment .. może usunąć poprzedni segment ścieżki.

Funkcja nie sprawdza poprawności ani bezpieczeństwa adresu. Koduje % jako %25, więc ponowne kodowanie zmienia istniejące sekwencje: %20 staje się %2520. Niesparowany surogat UTF-16 powoduje URIError; poprawna para surogatów jest kodowana jako jeden punkt kodowy.

Przykład pokazuje, które separatory pozostają bez zmian w podanym adresie URL, jak kodowane są é i spacja oraz czym różni się kodowanie całego URI od kodowania jego składnika.

Przykłady

const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));

Wynik

https://example.com/caf%C3%A9%20menu?q=tea&size=large#top
tea%26size%3Dlarge
%2520

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła