Error  - AS3

Belirli bir hata mesajı ile ilişkili başvuru numarasını içerir. Özel bir Error nesnesi için bu sayı, yapıcıda verilen id parametresinden alınan değerdir.

Error nesnesi ile ilişkili mesajı içerir. Varsayılan olarak bu özelliğin değeri "Error" şeklindedir. Error nesnesi oluştururken Error yapıcı işlevine hata dizesini ileterek bir message özelliği belirtebilirsiniz.

İlgili API Öğeleri

Error nesnesinin adını içerir. Varsayılan olarak bu özelliğin değeri "Error" şeklindedir.

İlgili API Öğeleri

Yeni bir Error nesnesi oluşturur. message değeri belirtilirse, bunun değeri nesnenin Error.message özelliğine atanır.

İlgili API Öğeleri

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

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

Hatanın oluştuğu zamanda, bir hata için dize şeklinde çağrı yığını döndürür. Şu örnekte gösterildiği gibi, döndürülen değerin ilk satırı istisna nesnesini temsil eden dizedir; ardından yığın izleme öğeleri gelir:

     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]
        

Aşağıdaki listeleme, bu yöntemin, Flash Player'ın hata ayıklayıcı bir sürümünde çağrıldığında geçerli olan değerini veya AIR Hata Ayıklama Başlatıcısı'nda (ADL) çalışan kodu gösterir. Kod, bir Flash Player veya AIR yayın sürümünde çalıştığında yığın izleme özelliği şu örnekte olduğu gibi dosya yolu ve satır numarası bilgileri olmaksızın sağlanır:

     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 ve önceki sürümleri ile AIR 3.4 ve önceki sürümleri için, yığın izlemeleri yalnızca kod Flash Player veya AIR Hata Ayıklama Başlatıcısı (ADL) hata ayıklama sürümünde çalıştığında kullanılabilir. Bu çalışma zamanlarının hata ayıklayıcı olmayan sürümlerinde, bu yöntem çağrıldığında null döndürülür.

Varsayılan olarak "Error" dizesini veya tanımlıysa Error.message özelliğinde bulunan değeri döndürür.

İlgili API Öğeleri

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 türündeki nullArray yerel değişkeni bildirilmiştir, ancak yeni bir Array nesnesinin hiç oluşturulmadığına dikkat edin.
2. Yapıcı, Error sınıfını genişleten CustomError sınıfıyla özel hata yakalayan bir hata işleme kod bölümü içinden push() yöntemini kullanarak, ilk değerleri atanmamış diziye bir değer yüklemeye çalışır.
3. CustomError sınıfı atıldığında yapıcı bunu yakalar ve trace() ifadesini kullanarak bir hata mesajını çıktı olarak verir.

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);
    }
}