Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

RangeError — wartość poza dozwolonym zakresem

RangeError to wbudowany typ błędu ECMAScript oznaczający wartość spoza dozwolonego zbioru lub zakresu. Pozwala sygnalizować nieprawidłowe argumenty i obsługiwać takie wyjątki przez try...catch.

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

new RangeError(message)
RangeError(message)
throw new RangeError(message)

RangeError jest wbudowanym typem błędu ECMAScript, którego instancje dziedziczą po Error. Oznacza wartość spoza dozwolonego zbioru lub zakresu; nie musi chodzić wyłącznie o przekroczenie granicy liczbowej. Nie jest to interfejs Web API.

new RangeError(message) tworzy obiekt błędu z opcjonalnym komunikatem. Wywołanie RangeError(message) bez new również tworzy nowy obiekt. Samo utworzenie błędu nie przerywa wykonania: do zgłoszenia wyjątku użyj throw new RangeError(message).

Niektóre operacje zgłaszają ten błąd automatycznie. Na przykład new Array(-1) odrzuca ujemną długość. Przy pojedynczym argumencie typu Number konstruktor Array wymaga całkowitej długości od 0 do 2 ** 32 - 1 włącznie. Odczyt elementu poza końcem zwykłej tablicy sam w sobie nie zgłasza RangeError.

Obsługuj oczekiwany wyjątek w try...catch, a niepowiązane błędy zgłaszaj ponownie. W przykładzie instanceof RangeError sprawdza typ w obrębie tego samego środowiska globalnego; obiekty z innego środowiska, np. ramki, mogą nie przejść tego testu. Nie porównuj komunikatów błędów generowanych przez silnik: ich treść nie jest przenośnym kontraktem.

Przykłady

try {
  new Array(-1);
} catch (error) {
  if (!(error instanceof RangeError)) throw error;
  console.log(error.name);
  console.log(error instanceof Error);
}

Wynik

RangeError
true

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

Źródła