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

CKTIS / JavaScript

ReferenceError — referencias de variables no válidas

ReferenceError es un tipo de error integrado de JavaScript que se produce, entre otros casos, al leer un nombre sin resolver o una variable antes de inicializarla. Aprende en qué se diferencia una variable inexistente de undefined y por qué typeof no evita las reglas de inicializació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 ReferenceError(message)
ReferenceError(message)

ReferenceError es un tipo de error integrado de ECMAScript que hereda de Error; no es una API web. El motor lo produce, entre otros casos, cuando un identificador que se está leyendo no se resuelve en un enlace accesible, por ejemplo, por un error tipográfico o al usar un nombre fuera de su ámbito. Una variable declarada e inicializada cuyo valor es undefined no equivale a un enlace inexistente.

Leer una variable declarada con let o const antes de inicializarla también produce un ReferenceError. Este intervalo se llama temporal dead zone (TDZ). El operador typeof devuelve "undefined" para un nombre sin resolver, pero no evita la TDZ: typeof value antes de inicializar un let value local produce un error. En cambio, la lectura normal de una propiedad inexistente de un objeto normal devuelve undefined, no ReferenceError.

new ReferenceError(message) crea un objeto de error; también se permite llamar a ReferenceError(message) sin new. El argumento message es opcional. Crear el objeto no lanza el error: para ello se necesita throw. Usa try...catch para gestionar errores previstos, pero corrige desde el origen los errores tipográficos y el orden incorrecto de inicialización. La redacción exacta de los mensajes generados por el motor puede variar entre implementaciones.

Ejemplos

(() => {
  try {
    console.log(typeof value);
    let value = 42;
  } catch (error) {
    console.log(error instanceof ReferenceError);
    console.log(error.name);
  }

  const custom = new ReferenceError("Missing binding");
  console.log(custom.message);
})();

Resultado

true
ReferenceError
Missing binding

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