Error (Objeto)

Artículo
08/10/2011

Contiene información acerca de los errores. El constructor Error presenta dos formas.

function Error([description : String ])
function Error([number : Number [, description : String ]])

Argumentos

number
Opcional. Valor numérico que, asignado al error, especifica el valor de la propiedad number. Si se omite, será cero.
description
Opcional. Cadena breve que describe el error y especifica el valor inicial de las propiedades description y message. Si se omite, será una cadena vacía.

Comentarios

Los objetos Error se pueden crear explícitamente utilizando el constructor anterior. Pueden agregarse propiedades al objeto Error para ampliar su capacidad. También se crea uno de estos objetos cada vez que se produce un error en tiempo de ejecución; en dicho caso, el objeto creado sirve de descripción.

Normalmente, un objeto Error se produce con la instrucción throw para poder ser capturado con una instrucción try...catch. Puede utilizarse una instrucción throw para pasar cualquier tipo de datos como error: la instrucción throw no creará un objeto Error de manera implícita. Sin embargo, al lanzar un objeto Error, un bloque catch puede tratar errores en tiempo de ejecución de JScript y errores definidos por el usuario de manera similar.

El objeto Error tiene cuatro propiedades intrínsecas: las referentes a la descripción del error (propiedades description y message), al número de error (propiedad number) y al nombre del error (propiedad name). Las propiedades description y message hacen referencia al mismo mensaje; la propiedad description proporciona compatibilidad con versiones anteriores, mientras que la propiedad message cumple el estándar ECMA.

Un número de error es un valor de 32 bits. La palabra de 16 bits superior es el código de facilidad, mientras que la palabra inferior es el código de error real. Para leer el código de error real, utilice el operador & (AND bit a bit) para combinar la propiedad number con el número hexadecimal 0xFFFF.

Precaución
El intento de utilizar el objeto Error de JScript en una página ASP.NET puede ocasionar resultados inesperados. Esto es consecuencia de una posible ambigüedad entre el objeto Error de JScript y el evento Error de la página ASP.NET. Utilice la clase System.Exception en lugar del objeto Error para el control de errores en las páginas ASP.NET.

Nota

Sólo JScript proporciona el objeto Error. Puesto que no deriva de un tipo de .NET Framework, no lo podrán utilizar otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes). Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos conformes a CLS, asegúrese de utilizar el tipo de datos System.Exception en lugar del objeto Error. Sin embargo, puede utilizar el objeto Error para anotar el tipo de identificadores que no sean parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código conforme a CLS.

Ejemplo

En el siguiente ejemplo se muestra un uso del objeto Error.

try {
   // Throw an error.
   throw new Error(42,"No question");
} catch(e) {
   print(e)
// Extract the error code from the error number.
   print(e.number & 0xFFFF)
   print(e.description)
}

El resultado de este código es: