CKTIS / JavaScript
TypeError — napaka zaradi nedovoljene operacije
TypeError je vgrajena vrsta napake v JavaScriptu, ki pogosto označuje operacijo, nezdružljivo s tipom vrednosti. Pri preverjanju argumentov funkcije jo lahko prestrežete ali izrecno sprožite.
Različica: 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 vgrajeni konstruktor za napake, ki dedujejo od Error, in ne vmesnik Web API. Običajno označuje operacijo, ki je vrednost ne podpira, na primer klic vrednosti, ki ni funkcija. Specifikacija ga uporablja tudi, kadar nobena druga vgrajena vrsta napake ustrezno ne opiše neuspeha.
Ob uspešni izvedbi tako new TypeError(message) kot klic TypeError(message) brez new vrneta nov objekt napake, ne da bi ga sprožila kot izjemo. Če želite dobljeni objekt izrecno sprožiti kot izjemo, uporabite throw. Argument message ni obvezen, vendar lahko njegova pretvorba v niz sproži izjemo, še preden se vrne objekt napake. Na primer, new TypeError(Symbol()) sproži izjemo TypeError brez izrecnega stavka throw.
Lastne funkcije lahko sprožijo TypeError, kadar argument ne izpolnjuje zahteve glede tipa. Za vrednost pravilnega tipa, ki pa je zunaj dovoljenega obsega, je običajno primernejši RangeError. V primeru catch prestreže pričakovano napako, druge napake pa sproži znova.
Logike ne zasnujte na natančnem besedilu sporočil, ki jih ustvari izvajalno okolje: njihovo besedilo ni standardizirano. Primer določa lastno sporočilo, zato je pričakovani izhod stabilen. Preverjanje instanceof TypeError je primerno znotraj istega realm, lahko pa odpove pri napakah iz drugega realm, na primer iz ločenega iframe.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.