Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

TypeError — błąd niedozwolonej operacji

TypeError to wbudowany rodzaj błędu JavaScript, często oznaczający operację niezgodną z typem wartości. Można go przechwycić albo jawnie zgłosić przy sprawdzaniu argumentów funkcji.

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 TypeError(message)
TypeError(message)
throw new TypeError(message)

TypeError jest wbudowanym konstruktorem błędów dziedziczących po Error, a nie interfejsem Web API. Zwykle sygnalizuje operację niedozwoloną dla danej wartości, np. wywołanie wartości niebędącej funkcją. Specyfikacja używa go także wtedy, gdy żaden inny wbudowany rodzaj błędu nie opisuje właściwie przyczyny niepowodzenia.

Po pomyślnym wykonaniu zarówno new TypeError(message), jak i wywołanie TypeError(message) bez new zwracają nowy obiekt błędu, zamiast go zgłaszać. Aby jawnie zgłosić utworzony obiekt, użyj throw. Argument message jest opcjonalny, ale jego konwersja na ciąg znaków może zgłosić wyjątek jeszcze przed zwróceniem obiektu błędu. Na przykład new TypeError(Symbol()) zgłasza TypeError bez jawnej instrukcji throw.

Własne funkcje mogą zgłaszać TypeError, gdy argument nie spełnia wymagań dotyczących typu. Dla wartości właściwego typu, ale poza dozwolonym zakresem, odpowiedniejszy jest zwykle RangeError. W przykładzie catch obsługuje oczekiwany błąd, a pozostałe zgłasza ponownie.

Nie uzależniaj logiki od dokładnego tekstu komunikatów generowanych przez silnik: nie jest on ujednolicony. Przykład używa własnego komunikatu, więc oczekiwany wynik jest stały. Test instanceof TypeError jest odpowiedni w tym samym środowisku globalnym, ale może zawieść dla błędów z innego środowiska, np. osobnego iframe.

Przykłady

function shout(value) {
  if (typeof value !== "string") {
    throw new TypeError("Expected a string");
  }
  return value.toUpperCase();
}

try {
  shout(42);
} catch (error) {
  if (!(error instanceof TypeError)) {
    throw error;
  }
  console.log(error.name + ": " + error.message);
}

Wynik

TypeError: Expected a string

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

Źródła