Error  - AS3

特定のエラーメッセージに関連付けられた参照番号です。カスタム Error オブジェクトの場合、この番号はコンストラクターで提供される id パラメーターの値です。

Error オブジェクトに関連付けられたメッセージです。デフォルトでは、このプロパティの値は "Error" です。Error オブジェクトを作成する際に、message プロパティを指定するには、Error コンストラクター関数にエラーストリングを渡します。

関連する API エレメント

Error オブジェクトの名前です。デフォルトでは、このプロパティの値は "Error" です。

関連する API エレメント

新しい Error オブジェクトを作成します。message を指定した場合は、その値がオブジェクトの Error.message プロパティに割り当てられます。

関連する API エレメント

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

エラー発生時のエラーの呼び出しスタックをストリングで返します。次の例に示されているように、戻り値の先頭行は、例外オブジェクトのストリング表現で、その後にはスタックトレースエレメントが続きます。

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
        

前述のリストでは、このメソッドを Flash Player のデバッガーバージョンで呼び出すか、AIR Debug Launcher（ADL）で実行中のコードで呼び出した場合の、このメソッドの値を示しています。コードが Flash Player または AIR のリリースバージョンで実行される場合、次の例のように、ファイルパスや行番号の情報なしでスタックトレースが取得されます。

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()
        

Flash Player 11.4 以前および AIR 3.4 以前では、Flash Player のデバッガーバージョンまたは AIR Debug Launcher（ADL）でコードを実行中の場合のみ、スタックトレースを取得できます。これらのランタイムの非デバッガーバージョンでは、このメソッドを呼び出すと null が返されます。

デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。

関連する API エレメント

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message

1. Array 型のローカル変数 nullArray を宣言しますが、新しい Array オブジェクトは作成されません。
2. コンストラクターはエラー処理コードセグメント内で push() メソッドを使用して、初期化されていない配列に値をロードしようとします。このエラー処理セグメントは、CustomError クラス（Error の拡張）を使用してカスタムエラーをキャッチします。
3. CustomError がスローされると、コンストラクターはこれをキャッチし、trace() ステートメントを使用してエラーメッセージを出力します。

package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}