Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TypeError — chyba při nepovolené operaci

TypeError je vestavěný typ chyby v JavaScriptu a často označuje operaci, která není slučitelná s typem hodnoty. Při kontrole argumentů funkce ji můžete zachytit nebo výslovně vyvolat.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new TypeError(message)
TypeError(message)
throw new TypeError(message)

TypeError je vestavěný konstruktor pro chyby dědící z Error, nikoli rozhraní Web API. Obvykle signalizuje operaci, kterou hodnota nepodporuje, například zavolání hodnoty, která není funkcí. Specifikace jej používá také tehdy, když žádný jiný vestavěný typ chyby nevystihuje selhání vhodněji.

Při úspěšném provedení vrátí jak new TypeError(message), tak volání TypeError(message) bez new nový objekt chyby, aniž ho vyhodí jako výjimku. Chcete-li získaný objekt výslovně vyhodit jako výjimku, použijte throw. Argument message je nepovinný, ale jeho převod na řetězec může vyvolat výjimku ještě před vrácením objektu chyby. Například new TypeError(Symbol()) vyvolá výjimku TypeError i bez explicitního příkazu throw.

Vlastní funkce mohou vyvolat TypeError, pokud argument nesplňuje požadavek na typ. U hodnoty správného typu, která je však mimo povolený rozsah, bývá vhodnější RangeError. V příkladu catch zachytí očekávanou chybu a ostatní chyby znovu vyvolá.

Nezakládejte logiku na přesném znění zpráv generovaných JavaScriptovým enginem: jejich formulace není standardizovaná. Příklad zadává vlastní zprávu, takže očekávaný výstup je stabilní. Kontrola instanceof TypeError je vhodná ve stejném realm, ale u chyb z jiného realm, například ze samostatného iframe, může selhat.

Příklady

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);
}

Výsledek

TypeError: Expected a string

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje