CKTIS / JavaScript
TypeError — un error por operación no válida
TypeError es un tipo de error integrado en JavaScript que suele indicar una operación incompatible con el tipo de un valor. Puedes capturarlo o lanzarlo explícitamente al validar los argumentos de una función.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new TypeError(message)
TypeError(message)
throw new TypeError(message)TypeError es un constructor integrado para errores que heredan de Error, no una interfaz de API web. Suele señalar una operación que un valor no admite, como llamar a un valor que no es una función. La especificación también lo utiliza cuando ningún otro tipo de error integrado describe adecuadamente el fallo.
Si se ejecutan correctamente, tanto new TypeError(message) como la llamada a TypeError(message) sin new devuelven un nuevo objeto de error en lugar de lanzarlo. Usa throw para lanzar explícitamente el objeto obtenido. El argumento message es opcional, pero su conversión a una cadena puede lanzar una excepción antes de que se devuelva un objeto de error. Por ejemplo, new TypeError(Symbol()) lanza un TypeError sin una instrucción throw explícita.
Tus funciones pueden lanzar TypeError cuando un argumento incumple un requisito de tipo. Si el valor tiene el tipo correcto, pero está fuera del intervalo permitido, normalmente es más adecuado RangeError. En el ejemplo, catch captura el error esperado y vuelve a lanzar los demás.
No bases la lógica en el texto exacto de los mensajes generados por el motor: su redacción no está estandarizada. El ejemplo proporciona su propio mensaje, por lo que la salida esperada es estable. Una comprobación instanceof TypeError es adecuada dentro del mismo entorno de ejecución, pero puede fallar con errores de otro entorno, como un iframe independiente.
Ejemplos
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);
}Resultado
TypeError: Expected a string
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.