Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URIError — błąd kodowania lub dekodowania URI

URIError to wbudowany typ błędu JavaScript sygnalizujący nieprawidłowe dane podczas kodowania lub dekodowania URI. Poznaj typowe przyczyny, tworzenie błędu i selektywną obsługę wyjątków.

Wersja: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.

Składnia

new URIError(message)
URIError(message)

URIError jest standardowym typem błędu ECMAScript dziedziczącym po Error, a nie interfejsem Web API. Nie oznacza dowolnego niepoprawnego adresu: dotyczy błędów operacji kodowania i dekodowania URI.

decodeURI i decodeURIComponent zgłaszają URIError, gdy napotkają niepoprawny zapis procentowy, np. %ZZ, albo sekwencję bajtów, która nie koduje poprawnego UTF-8. encodeURI i encodeURIComponent zgłaszają go dla niesparowanego surogatu UTF-16. Warianty z Component służą do poszczególnych składników URI; pozostałe uwzględniają rolę znaków zastrzeżonych w całym URI.

new URIError(message) tworzy obiekt; samo utworzenie go nie zgłasza wyjątku. Wywołanie URIError(message) bez new również tworzy obiekt. Aby zgłosić własny błąd, użyj throw new URIError(message). Właściwość name ma domyślnie wartość "URIError"; treść automatycznie wygenerowanego message zależy od implementacji.

Obejmij dekodowanie niezaufanych danych blokiem try...catch. W typowym kodzie działającym w jednym środowisku globalnym sprawdzaj error instanceof URIError i ponownie zgłaszaj pozostałe wyjątki. To sprawdzenie może zawieść dla błędu z innego środowiska globalnego, np. innej ramki. Przykład dekoduje poprawny tekst i obsługuje niepełną sekwencję UTF-8, nie polegając na treści komunikatu.

Przykłady

for (const input of ["hello%20world", "%E0%A4"]) {
  try {
    console.log(decodeURIComponent(input));
  } catch (error) {
    if (!(error instanceof URIError)) throw error;
    console.log(error.name);
  }
}

Wynik

hello world
URIError

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

Źródła