错误类型

开发和运行应用程序时，您会遇到不同类型的错误和错误术语。下面列出了主要的错误类型和术语：

编译时错误，这类错误在代码编译期间由 ActionScript 编译器引发。当代码中的语法问题导致应用程序无法生成时即会发生编译时错误。

运行时错误，这类错误在应用程序编译之后运行时发生。运行时错误指在 Adobe Flash Player 9 中播放 SWF 文件时产生的错误。大多数情况下，您都可以在运行时错误发生时对其进行处理，将错误报告给用户，并采取相应的步骤让应用程序继续运行。如果是致命错误，如未能连接到远程 Web 站点或未能加载需要的数据，则可以使用错误处理让应用程序妥善地终止运行。

同步错误，这类错误是在调用某个函数时发生的运行时错误。例如，当试图使用某个特定方法但传递给该方法的参数无效时，Flash Player 就会引发异常。多数错误都是在语句执行时同步发生，并且控制流会立即传递给最适用的 catch 语句。

例如，以下代码将会引发一个运行时错误，原因是在程序试图上载文件之前没有调用 browse() 方法：

var fileRef:FileReference = new FileReference();
try
{
    fileRef.upload("http://www.yourdomain.com/fileupload.cfm");
}
catch (error:IllegalOperationError)
{
    trace(error);
    // 错误 #2037：函数的调用顺序不正确，或者之前的
    // 调用未成功。
}

在本例中，将同步引发一个运行时错误，原因是 Flash Player 断定在试图上载文件之前没有调用 browse() 方法。

有关同步错误处理的详细信息，请参阅在应用程序中处理同步错误。

异步错误，这类错误是在应用程序运行期间在不同点处发生的运行时错误，它们会产生相应事件并由事件侦听器捕获。在异步操作中，函数发起操作但并不等待操作完成。您可以创建错误事件侦听器来等待应用程序或用户尝试执行某个操作。如果操作失败，则使用一个事件侦听器捕获错误并响应错误事件。然后，该事件侦听器调用一个事件处理函数，以便通过一种有益的方式来响应错误事件。例如，事件处理函数可以启动一个对话框，以提示用户解决该错误。

下面以前面提到的文件上载同步错误为例。如果在文件上载开始之前成功调用了 browse() 方法，则 Flash Player 会调度若干个事件。例如，上载开始时，将调度 open 事件。文件上载操作成功完成时，将调度 complete 事件。由于事件处理是异步的（即不是在特定、已知或预先指定的时间发生），因此需要使用 addEventListener() 方法来侦听这些特定的事件，如以下代码所示：

var fileRef:FileReference = new FileReference();
fileRef.addEventListener(Event.SELECT, selectHandler);
fileRef.addEventListener(Event.OPEN, openHandler);
fileRef.addEventListener(Event.COMPLETE, completeHandler);
fileRef.browse();

function selectHandler(event:Event):void
{
    trace("...select...");
    var request:URLRequest = new URLRequest("http://www.yourdomain.com/fileupload.cfm");
    request.method = URLRequestMethod.POST;
    event.target.upload(request.url);
}
function openHandler(event:Event):void
{
    trace("...open...");
}
function completeHandler(event:Event):void
{
    trace("...complete...");
}

有关异步错误处理的详细信息，请参阅响应错误事件和状态。

未捕获的异常，这类错误在引发后并没有相应的逻辑（如 catch 语句）来响应它。应用程序引发错误后，如果在当前级别或更高级别找不到适当的 catch 语句或事件处理函数来处理错误，则认为该错误是未捕获的异常。

鉴于用户不一定能够自行解决错误，如果错误并未使当前 SWF 文件停止播放，按照设计，Flash Player 在运行时将忽略未捕获的异常并尝试继续播放该文件。忽略未捕获异常的过程称为"无提示失败"，它会使应用程序的调试变得非常复杂。Flash Player 的调试版对未捕获异常的响应方式是终止当前脚本并在 trace 语句输出中显示未捕获的异常或将错误消息写入日志文件。如果异常对象是 Error 类或其子类的一个实例，则将调用 getStackTrace() 方法，并且还会在 trace 语句输出或日志文件中显示堆栈跟踪信息。有关使用 Flash Player 调试版的详细信息，请参阅处理 Flash Player 的调试版。