Error  - AS3

Contém o número de referência associado à mensagem de erro específica. Para um objeto Error personalizado, esse número é o valor do parâmetro id fornecido no construtor.

Contém a mensagem associada ao objeto Error. Por padrão, o valor dessa propriedade é "Error". É possível especificar uma propriedade message ao criar um objeto Error transmitindo a string de erro à função de construtor Error.

Elementos da API relacionados

Contém o nome do objeto Error. Por padrão, o valor dessa propriedade é "Error".

Elementos da API relacionados

Cria um novo objeto Error. Se message for especificado, seu valor será atribuído à propriedade Error.message do objeto.

Elementos da API relacionados

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

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

Retorna a pilha de chamada para um erro no momento da construção do erro como sequência de caracteres. Como mostra o exemplo a seguir, a primeira linha do valor de retorno é a representação de string do objeto de exceção, seguido dos elementos de rastreamento de pilha:

     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 lista anterior mostra o valor deste método quando uma versão de depuração do Flash ou código em execução no AIR Debug Launcher (ADL) é chamada. Quando o código se depara com uma versão de lançamento do Flash Player ou AIR, o rastreamento da pilha é fornecido sem o caminho do arquivo e as informações de número de linha, como no exemplo a seguir:

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

No Flash Player 11.4 e anterior e no AIR 3.4 e anterior, os rastreamentos de pilha estão disponíveis somente quando o código está em execução na versão do depurador do Flash Player ou no AIR Debug Launcher (ADL). Em versões não depurador desses runtimes, a chamada deste método retorna null.

Retorna a string "Erro" por padrão ou o valor contido na propriedade Error.message, se definida.

Elementos da API relacionados

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. Uma variável local nullArray do tipo Array é declarada, mas note que um novo objeto Array nunca é criado.
2. O construtor tenta carregar um valor na matriz não inicializada, usando o método push() em um segmento de código de manipulação de erros que detecta um erro personalizado com o uso da classe CustomError, que estende Error.
3. Quando CustomError é lançado, o construtor o detecta e então processa uma mensagem de erro usando a instrução 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);
    }
}