Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła