CKTIS / JavaScript
TypeError — chyba pri nepovolenej operácii
TypeError je vstavaný typ chyby v JavaScripte a často označuje operáciu nezlučiteľnú s typom hodnoty. Pri kontrole argumentov funkcie ju môžete zachytiť alebo výslovne vyvolať.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new TypeError(message)
TypeError(message)
throw new TypeError(message)TypeError je vstavaný konštruktor pre chyby dediace z Error, nie rozhranie Web API. Zvyčajne signalizuje operáciu, ktorú hodnota nepodporuje, napríklad zavolanie hodnoty, ktorá nie je funkciou. Špecifikácia ho používa aj vtedy, keď žiadny iný vstavaný typ chyby nevystihuje zlyhanie vhodnejšie.
Pri úspešnom vykonaní vrátia new TypeError(message) aj volanie TypeError(message) bez new nový objekt chyby bez toho, aby ho vyhodili ako výnimku. Ak chcete získaný objekt výslovne vyhodiť ako výnimku, použite throw. Argument message je nepovinný, ale jeho prevod na reťazec môže vyvolať výnimku ešte pred vrátením objektu chyby. Napríklad new TypeError(Symbol()) vyvolá výnimku TypeError aj bez explicitného príkazu throw.
Vlastné funkcie môžu vyvolať TypeError, ak argument nespĺňa požiadavku na typ. Pre hodnotu správneho typu, ktorá je však mimo povoleného rozsahu, býva vhodnejší RangeError. V príklade catch zachytí očakávanú chybu a ostatné chyby znova vyvolá.
Nezakladajte logiku na presnom znení správ generovaných JavaScriptovým enginom: ich formulácia nie je štandardizovaná. Príklad zadáva vlastnú správu, takže očakávaný výstup je stabilný. Kontrola instanceof TypeError je vhodná v tom istom realm, ale pri chybách z iného realm, napríklad zo samostatného iframe, môže zlyhať.
Prí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ýsledok
TypeError: Expected a string
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.