Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes