Microsoft Asp.Net Ajax框架入门(6) Debugging and Typed Errors

VS2008

本文介绍在开发客户端Javascript的时候，如何输出调试信息，以及如何定义自定义异常类型并捕获。

1. Sys.Debug
    Microsoft AJAX Library提供了一个Sys.Debug的类，用于调试的时候将调试信息输出，有了它我们就不再需要使用蹩脚的alert的方法了。
    为了让调试跟踪信息在页面上展现，我们需要在页面上加入一个名为TraceConsole的的textarea控件

<textarea id="TraceConsole" cols="50" rows="10"></textarea>

1.1 Sys.Debug.trace
    方法定义 Sys.Debug.trace(text)
    这个方法的功能是：将一个跟踪文本信息在TraceConsole中显示

Sys.Debug.trace("this is a debug message");

    页面执行完之后就会在TraceConsole中显示这句文本。
1.2 Sys.Debug.traceDump
    方法定义 Sys.Debug.traceDump(Object, string name)
    这个方法的功能是：将一个对象的所有属性信息（包括值）在TraceConsole中显示
    假设我页面上有一个名为"form1"的元素，

Sys.Debug.traceDump(Sys.UI.DomElement.getLocation( $get("form1") ));

    那么，在TraceConsole中我将看到如下信息：
    traceDump {Sys.UI.Point}
    x: 10
    y: 15

1.3 Sys.Debug.assert
    方法定义 Sys.Debug.assert(Boolean condition, string message, Boolean displayCaller)
    也就是我们在Unit Test中常见的断言，当condition为false的时候，脚本执行会异常终止，并提示message信息，如果displayCaller为true的话，将显示断言所属的调用者（函数）
    

Sys.Debug.assert(1>2, "1 怎么会大于 2呢", false);

    这时会有一个windows警告框弹出，并提示 message 信息。

2. 异常与try...catch代码块
2.1 使用内建的异常类型
    在Error下的几个方法可以帮助我们创建几个常用的内建的异常类型
    例：

try {
                throw Error.argumentNull();
            }
            catch(e) {
                Sys.Debug.traceDump(e);
            }

    TraceConsole中输出的信息为：
    traceDump {Error}
    description: Sys.ArgumentNullException: Value cannot be null.
    message: Sys.ArgumentNullException: Value cannot be null.
    name: Sys.ArgumentNullException
    paramName: Undefined

2.2 使用自定义异常类型
    可以通过Error的create自定义异常类型：

var myError = Error.create("myError", {name: " xxx", desc : "my cc"});
            try {
                throw myError;
            }
            catch(e) {
                Sys.Debug.traceDump(e);
            }

    
    TraceConsole输出：

traceDump {Error}
    description: myError
    message: myError
    name:  xxx
    desc: my cc