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.