Error  - AS3

Zawiera numer odwołania skojarzony z konkretnym komunikatem o błędzie. Dla niestandardowego obiektu Error ta liczba stanowi wartość parametru id udostępnioną przez konstruktora.

Zawiera komunikat skojarzony z obiektem Error. Domyślnie ta właściwość jest ustawiona na wartość „Error”. Poprzez przesłanie ciągu błędu do funkcji konstruktora Error można określić właściwość message podczas tworzenia obiektu Error.

Powiązane elementy interfejsu API

Zawiera nazwę obiektu Error. Domyślnie ta właściwość jest ustawiona na wartość „Error”.

Powiązane elementy interfejsu API

Tworzy nowy obiekt Error. Po określeniu komunikatu message jego wartość zostaje przypisana do właściwości Error.message obiektu.

Powiązane elementy interfejsu API

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

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

Zwraca ciąg reprezentujący stos wywołań związanych z błędem, który istniał w momencie uruchomienia konstruktora błędu. Jak pokazano w poniższym przykładzie, pierwszy wiersz zwróconej wartości to ciąg znaków reprezentujący obiekt wyjątku, po którym następują trzy elementy historii stosu.

     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]
        

Powyższy kod przedstawia wartość tej metody w przypadku wywołania jej w programie Flash Player z włączonym debugerem lub w programie ADL (AIR Debug Launcher). Jeśli ten kod jest uruchomiony w standardowej wersji programu Flash Player lub środowiska AIR, stos wywołań jest podawany bez ścieżki do pliku i informacji o numerze wiersza — jak na poniższym przykładzie.

     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()
        

W przypadku programu Flash Player 11.4 lub starszego oraz środowiska AIR 3.4 lub starszego stosy wywołań są dostępne tylko wtedy, gdy kod jest uruchomiony w programie Flash Player w wersji z debugerem lub w programie ADL (AIR Debug Launcher). Wywołanie tej metody w wersjach tych środowisk wykonawczych bez debugera powoduje zwrócenie wartości null.

Domyślnie zwraca ciąg "Error" lub wartość określoną przez właściwość Error.message (jeśli określona).

Powiązane elementy interfejsu 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. Lokalna zmienna nullArray typu Array zostaje zadeklarowana bez utworzenia nowego obiektu Array.
2. Konstruktor próbuje załadować wartość do nieistniejącej tablicy za pomocą metody push() wraz z segmentem kodu obsługującego błąd, który przechwytuje niestandardowy błąd za pomocą klasy CustomError, co powoduje rozszerzenie obiektu Error.
3. Konstruktor przechwytuje wywołaną klasę CustomError, a następnie za pomocą instrukcji trace() generuje komunikat o błędzie.

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