Flash Player 10.1　のエラー処理機能 （グローバルエラー編 2）

import flash.events.UncaughtErrorEvent;
 
public class UncaughtErrorEventExample extends Sprite
{
  var loader:Loader;
 
  public function LoaderUncaughtErrorEventExample()
  {
    loader = new Loader();
    loader.uncaughtErrorEvents.addEventListener(
        UncaughtErrorEvent.UNCAUGHT_ERROR, onUncaughtError);
    loader.load(new URLRequest("bar.swf"));
  }
  private function onUncaughtError(event:UncaughtErrorEvent):void
  {
    event.stopPropagation();
    // エラー処理を記述
  }
}
 

stopPropagation() の動作について

stopPropagation() メソッドを呼んだ場合、イベントフローは、その時点でターゲットとなっているオブジェクトで終わり、フローの後続のオブジェクトにはイベントが伝わりません。

UncaughtErrorEvent の場合は、この点がすこし異なります。Loader オブジェクトの UncaughtErrorEvents （末尾に s 付いてます） は、読み込まれた SWF 内の LoaderInfo の UncaughtErrorEvents とペアとして扱われます。先の例では、foo.swf 内の Loader と bar.swf の LoaderInfo がペアの関係になります。

そして、イベントフローがペアの LoaderInfo → Loader の順だったとして、LoaderInfo に登録されている UncaughtErrorEvent のイベントハンドラーが stopPropagation() を呼んだ場合、フローは LoaderInfo では止まらずにペアの Loader にも伝わってから終了します。

これに対して、stopImmediatePropagation() メソッドを呼んだ場合は、通常のイベントフローと同様に、その場でイベントフローが終了します。同じオブジェクトに登録されている他のイベントハンドラーも （まだ呼ばれていないものがあった場合） 呼ばれません。

デバッグ版でのエラーダイアログ

Flash Player や AIR のデバッグ版を使うと、未処理の実行時エラーが発生するたびに、ダイアログが表示されてエラー情報が通知されます。この動きは、UncaughtErrorEvent のイベントハンドラーを追加して、未処理のエラーを受け付けるようにしても変わりません。

エラーダイアログが表示されないようにしたいときは、イベントハンドラー内で UncaughtErrorEvent イベントに対して preventDefault() メソッドを呼ぶとよいようです。