CKTIS / JavaScript
TypeError — une erreur d’opération non valide
TypeError est un type d’erreur intégré à JavaScript, qui indique souvent qu’une opération est incompatible avec le type d’une valeur. Vous pouvez l’intercepter ou le déclencher explicitement lors de la validation des arguments d’une fonction.
Version : 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 est un constructeur intégré pour les erreurs qui héritent de Error, et non une interface d’API Web. Il signale généralement une opération qu’une valeur ne prend pas en charge, comme l’appel d’une valeur qui n’est pas une fonction. La spécification l’utilise aussi lorsqu’aucun autre type d’erreur intégré ne décrit correctement l’échec.
S’ils réussissent, new TypeError(message) et l’appel à TypeError(message) sans new renvoient tous deux un nouvel objet d’erreur au lieu de le lever comme exception. Pour lever explicitement l’objet obtenu, utilisez throw. L’argument message est facultatif, mais sa conversion en chaîne peut lever une exception avant qu’un objet d’erreur ne soit renvoyé. Par exemple, new TypeError(Symbol()) lève une exception TypeError sans instruction throw explicite.
Vos fonctions peuvent déclencher TypeError lorsqu’un argument ne respecte pas une exigence de type. Pour une valeur du bon type, mais située hors de la plage autorisée, RangeError est généralement plus approprié. Dans l’exemple, catch intercepte l’erreur attendue et relance les autres erreurs.
Ne fondez pas votre logique sur le texte exact des messages générés par le moteur : leur formulation n’est pas normalisée. L’exemple fournit son propre message, ce qui rend la sortie attendue stable. Une vérification instanceof TypeError convient dans le même environnement d’exécution, mais peut échouer pour des erreurs provenant d’un autre environnement, comme un iframe distinct.
Exemples
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);
}Résultat
TypeError: Expected a string
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.