デバッガ版の Flash Player を使用すると、trace() グローバルメソッドからの出力をキャプチャして、クライアントのログファイルに書き込むことができます。trace() ステートメントはアプリケーションに含まれる任意の ActionScript ファイルと MXML ファイルで使用できます。これはグローバル関数なので、ActionScript クラスパッケージをインポートしなくても、trace() メソッドを使用できます。

次の例では、Button コントロールの起動ライフサイクルの各種段階をログする関数を定義します。

<?xml version="1.0"?>
<!-- logging/ButtonLifeCycle.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:Script><![CDATA[
        private function traceEvent(event:Event):void {
            trace(event.currentTarget + ":" + event.type);
        }
    ]]></mx:Script>

    <mx:Button id="b1" label="Click Me"
        preinitialize="traceEvent(event)"
        initialize="traceEvent(event)" 
        creationComplete="traceEvent(event)"
        updateComplete="traceEvent(event)"
    />

</mx:Application>
前の例で実行する SWF ファイルは以下のとおりです。

次の例は、この単純なアプリケーションの出力を示しています。

TraceLifecycle_3.b1:Button:preinitialize
TraceLifecycle_3.b1:Button:initialize
TraceLifecycle_3.b1:Button:creationComplete
TraceLifecycle_3.b1:Button:updateComplete
TraceLifecycle_3.b1:Button:updateComplete
TraceLifecycle_3.b1:Button:updateComplete

trace() メソッドでログするメッセージは、文字列である必要があります。出力が文字列でない場合は、trace() メソッドを呼び出す前に、String(...) 文字列変換関数を使用するか、または可能であれば、オブジェクトの toString() メソッドを使用します。

トレースを有効にするには、trace() 出力を記録するためのデバッガ版の Flash Player の設定の説明に従って、デバッガ版の Flash Player を設定する必要があります。