Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TypeError — pogreška zbog nedopuštene operacije

TypeError je ugrađena vrsta pogreške u JavaScriptu koja često označava operaciju nespojivu s vrstom vrijednosti. Možete je uhvatiti ili izričito pokrenuti pri provjeri argumenata funkcije.

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

Sintaksa

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

TypeError je ugrađeni konstruktor za pogreške koje nasljeđuju od Error, a ne sučelje Web API-ja. Obično označava operaciju koju vrijednost ne podržava, primjerice pozivanje vrijednosti koja nije funkcija. Specifikacija ga koristi i kada nijedna druga ugrađena vrsta pogreške ne opisuje neuspjeh na odgovarajući način.

Ako se uspješno izvrše, i new TypeError(message) i poziv TypeError(message) bez new vraćaju novi objekt pogreške umjesto da ga bace kao iznimku. Da biste dobiveni objekt izričito bacili kao iznimku, upotrijebite throw. Argument message nije obavezan, no njegova pretvorba u znakovni niz može izazvati iznimku prije nego što se vrati objekt pogreške. Primjerice, new TypeError(Symbol()) baca iznimku TypeError bez izričite naredbe throw.

Vlastite funkcije mogu pokrenuti TypeError kada argument ne ispunjava zahtjev za tip. Za vrijednost ispravnog tipa koja je izvan dopuštenog raspona obično je prikladniji RangeError. U primjeru catch hvata očekivanu pogrešku, a ostale ponovno pokreće.

Nemojte temeljiti logiku na točnom tekstu poruka koje generira JavaScriptov mehanizam: njihov tekst nije standardiziran. Primjer navodi vlastitu poruku pa je očekivani izlaz stabilan. Provjera instanceof TypeError prikladna je unutar istog realm-a, ali može zakazati za pogreške iz drugog realm-a, primjerice iz zasebnog iframe-a.

Primjeri

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

Rezultat

TypeError: Expected a string

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori