CKTIS / JavaScript
decodeURI — dekodowanie URI
decodeURI dekoduje sekwencje procentowe w tekście URI, zachowując zakodowane separatory, takie jak %2F. Poznaj różnicę względem decodeURIComponent oraz obsługę błędnych danych.
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
decodeURI(encodedURI)decodeURI(encodedURI) to globalna funkcja ECMAScript przeznaczona do dekodowania całych URI. Najpierw przekształca argument na tekst, a następnie zwraca nowy tekst: sekwencje %HH reprezentujące bajty UTF-8 zamienia na odpowiadające im znaki Unicode. Nie modyfikuje wejścia i nie wymaga interfejsów przeglądarki.
Zachowuje sekwencje procentowe oznaczające znaki ;/?:@&=+$,#, łącznie z wielkością liter cyfr szesnastkowych. Dlatego %20 staje się spacją, ale %2F pozostaje %2F. Zwykły znak + także pozostaje bez zmian: funkcja nie dekoduje formularzowej konwencji zastępowania spacji znakiem +.
decodeURIComponent służy do pojedynczych składników URI i dekoduje również zakodowane separatory, na przykład %2F do /. Nie stosuj go bez zastanowienia do całego URI, ponieważ może to zmienić granice jego składników. decodeURI nie jest parserem ani walidatorem poprawności całego adresu.
Niepoprawna sekwencja procentowa, taka jak %ZZ, lub niepełne bądź nieprawidłowe kodowanie UTF-8 powoduje wyjątek URIError, zamiast zwrócenia częściowego wyniku. Dla danych zewnętrznych obsłuż ten przypadek przez try...catch. Dekoduj tylko wymaganą warstwę kodowania: kolejne wywołanie może ponownie zmienić wynik, na przykład %2520 najpierw daje %20, a potem spację.
Przykłady
const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));
try {
decodeURI('%E0%A4');
} catch (error) {
console.log(error.name);
}Wynik
/café menu?q=a%2Fb+c /café menu?q=a/b+c URIError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.