CKTIS / JavaScript
decodeURIComponent — dekodowanie składnika URI
decodeURIComponent dekoduje sekwencje procentowe w pojedynczym składniku URI, odczytując zakodowane bajty jako UTF-8. Zwraca tekst, pozostawia znak + bez zmian i zgłasza URIError dla niepoprawnego kodowania.
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
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) to globalna funkcja ECMAScript służąca do dekodowania pojedynczego składnika URI. Najpierw konwertuje argument na tekst, a następnie zastępuje sekwencje %HH odpowiednimi znakami, interpretując zakodowane bajty jako UTF-8. Zwraca tekst; nie zmienia argumentu.
W przeciwieństwie do decodeURI dekoduje również zakodowane znaki zastrzeżone, takie jak %26, %2F i %3D. Najpierw wydziel składniki adresu, a dopiero potem dekoduj ich wartości: wcześniejsze dekodowanie może zamienić dane w separatory. Zwykły znak + pozostaje bez zmian; funkcja nie traktuje go jak spacji.
Niepełne sekwencje procentowe, niepoprawne cyfry szesnastkowe lub nieprawidłowy UTF-8 powodują URIError. Przy danych z zewnątrz obsłuż ten wyjątek. Dekoduj zgodnie z oczekiwaną liczbą warstw kodowania: %252F po jednym wywołaniu daje %2F, a po drugim /.
Przykład pokazuje dekodowanie tekstu Unicode i znaków zastrzeżonych, zachowanie + oraz obsługę błędnego wejścia. Jest to funkcja języka ECMAScript, a nie API wymagające środowiska przeglądarki.
Przykłady
const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));
try {
decodeURIComponent("%E0%A4%A");
} catch (error) {
console.log(error.name);
}Wynik
café & tea+cake a+b URIError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.