Extensiones de tipo de error

Actualización: noviembre 2007

Proporciona funciones estáticas que extienden el tipo ECMAScript (JavaScript) Error integrado mediante la inclusión de detalles de excepción y compatibilidad con los modos de compilación (depuración o lanzamiento) de la aplicación.

Espacio de nombres: ninguno. Esta extensión de tipo es global y no forma parte de un espacio de nombres.

Hereda: nada

var err = Error.create(message, errorInfo);

Extensiones de miembro

Comentarios

Las extensiones de Error forman parte de Microsoft AJAX Library. Agregan funcionalidad al objeto de JavaScript Error integrado.

Tipos de error

Las extensiones de tipo Error generan un tipo Error con campos adicionales que representan los detalles de la excepción. Todas las extensiones de tipo Error agregan al menos un campo name para identificar la excepción. Puede comprobar el campo name de la excepción para determinar qué acción debe realizar.

En el ejemplo siguiente se muestra cómo probar la propiedad Error,name para la excepción Sys.ArgumentNullException.

try{ } 
catch (e) {
    if (e.name === "Sys.ArgumentNullException"){
        // Code here ot handle exception.
    }
}

Para obtener más información sobre el objeto JavaScript que extiende este tipo, vea Error (Objeto) en Referencia del lenguaje.

Optimizar el control de errores de script de cliente para los modos de depuración y lanzamiento

Las extensiones del objeto AJAX de ASP.NET Error proporcionan funciones de control de errores de script de cliente adicionales.

ASP.NET proporciona modos de compilación de aplicación de depuración y lanzamiento para trabajar con el script de cliente AJAX. Estos modos permiten provocar excepciones en scripts de depuración que sean útiles para el proceso de depuración y, al mismo tiempo, reducir el tamaño del código de la versión de lanzamiento para mejorar el rendimiento. El modo de depuración proporciona características adicionales de control de errores, como la comprobación de tipo y argumento, y proporciona mensajes de error más detallados que el modo de lanzamiento.

Para obtener más información, consulte Cómo: Habilitar la depuración de aplicaciones de ASP.NET y Información general sobre la depuración y la traza de aplicaciones habilitadas para AJAX.

Ejemplo

En el ejemplo siguiente se muestra cómo crear una nueva instancia de Error invocando el método create del objeto AJAX de ASP.NET Error.

function validateNumberRange(input, min, max) 
{

    // Verify the required parameters were defined.
    if (input === undefined)
    {
        // Throw a standard exception type.
        var err = Error.argumentNull("input", "A parameter was undefined."); 
        throw err;
    }
    else if (min === undefined)
    {
        var err = Error.argumentNull("min", "A parameter was undefined."); 
        throw err;
    }
    else if (max === undefined)
    {
        var err = Error.argumentNull("max", "A parameter was undefined."); 
        throw err;
    }
    else if (min >= max)
    {
        var err = Error.invalidOperation("The min parameter must be smaller than max parameter.");
        throw err;
    }
    else if (isNaN(input))
    {
        msg = "A number was not entered.  ";
        msg += String.format("Please enter a number between {0} and {1}.", min, max);

        var err = Error.create(msg);
        throw err;
    }
    else if (input < min || input > max)
    {
        msg = "The number entered was outside the acceptable range.  ";
        msg += String.format("Please enter a number between {0} and {1}.", min, max);

        var err = Error.create(msg);
        throw err
    }

    alert("The number entered was within the acceptable range.");
}


var input = undefined;
var min = -10;
var max = 10;

// Result: A thrown ErrorArgumentNull exception with the following Error object message:
// "Sys.ArgumentNullException: A parameter was undefined. Parameter name: input"
validateNumberRange(input, min, max);

Vea también

Conceptos

Información general sobre la depuración y la traza de aplicaciones habilitadas para AJAX

Referencia

Error (Objeto)

new (Operador)

Funciones de tipo de error

Campos de tipo de error

Otros recursos

Referencia del lenguaje