CKTIS / JavaScript
TypeError — een fout bij een ongeldige bewerking
TypeError is een ingebouwd JavaScript-fouttype dat vaak aangeeft dat een bewerking niet past bij het type van een waarde. Je kunt de fout opvangen of expliciet genereren bij het controleren van functieargumenten.
Versie: 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 is een ingebouwde constructor voor fouten die overerven van Error, en geen Web API-interface. De fout duidt vaak op een bewerking die een waarde niet ondersteunt, zoals het aanroepen van een waarde die geen functie is. De specificatie gebruikt dit type ook wanneer geen ander ingebouwd fouttype de mislukking goed beschrijft.
Als de uitvoering slaagt, geven zowel new TypeError(message) als de aanroep TypeError(message) zonder new een nieuw foutobject terug in plaats van het als uitzondering op te werpen. Gebruik throw om het verkregen object expliciet als uitzondering op te werpen. Het argument message is optioneel, maar bij de omzetting ervan naar een tekenreeks kan een uitzondering optreden voordat er een foutobject wordt teruggegeven. Zo werpt new TypeError(Symbol()) een TypeError op zonder expliciete throw-instructie.
Je eigen functies kunnen TypeError genereren wanneer een argument niet aan een typevereiste voldoet. Voor een waarde van het juiste type die buiten het toegestane bereik valt, is RangeError meestal geschikter. In het voorbeeld vangt catch de verwachte fout op en wordt elke andere fout opnieuw gegenereerd.
Baseer je logica niet op de exacte tekst van door de engine gegenereerde meldingen: de formulering is niet gestandaardiseerd. Het voorbeeld geeft zelf een melding op, waardoor de verwachte uitvoer stabiel is. Een controle met instanceof TypeError is geschikt binnen dezelfde realm, maar kan mislukken bij fouten uit een andere realm, bijvoorbeeld een afzonderlijke iframe.
Voorbeelden
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);
}Resultaat
TypeError: Expected a string
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.