Dokumentacja języka JavaScript 1.5:Funkcje:encodeURI
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
Spis treści |
[edytuj] Podsumowanie
Funkcja główna
Koduje Jednolity Identyfikator Zasobu (URI) poprzez zamianę każdego z wystąpień pewnych znaków na jedną, dwie lub trzy sekwencje ucieczki (ang. escape sequences) kodowania UTF-8 danego znaku.
[edytuj] Składnia
encodeURI(URI)
[edytuj] Parametry
-
URI - Kompletny Jednolity Identyfikator Zasobu.
[edytuj] Opis
Zakłada się, iż URI jest kompletnym URI, więc nie koduje znaków zarezerwowanych, mających specjalne znaczenie w URI.
encodeURI zamienia wszystkie znaki, poza podanymi poniżej, odpowiednimi sekwencjami ucieczki.
| Typ | Zawiera |
| Znaki zarezerwowane | ; , / ? : @ & = + $ |
| Znaki nie podlegające ucieczce | Litery, cyfry, - _ . ! ~ * ' ( ) |
| Score | # |
Zauważ, że encodeURI samo z siebie nie potrafi utworzyć poprawnych żądań HTTP GET i POST, jak na przykład XMLHTTPRequest, ponieważ "&", "+", i "=" nie są kodowane, a są traktowane jako znaki specjalne w żądaniach GET i POST. Jednakże, encodeURIComponent, koduje te znaki. Zachowania te są konsekwentnie wspomagane przez różne przeglądarki.