PaqueteNivel superior
Clasepublic dynamic class Error
HerenciaError Inheritance Object
Subclases ArgumentError, DefinitionError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase Error contiene información sobre los errores que se han producido en un script. Al desarrollar aplicaciones ActionScript 3.0, cuando ejecute el código compilado en una versión de depurador de Flash Player, un cuadro de diálogo mostrará las excepciones de tipo Error, o de una subclase, para ayudarle a resolver los problemas existentes en el código. Puede crear un objeto Error utilizando la función constructora Error. Normalmente, emitirá un nuevo objeto Error desde dentro de un bloque de código try que será detectado por un bloque de código catch o finally.

También puede crear una subclase de la clase Error y emitir instancias de dicha subclase.

Ver los ejemplos

Véase también

Utilización de la versión de depuración de Flash Player
Creación de clases de error personalizadas
Respuesta al estado y a los eventos de error


Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  errorID : int
[read-only] Contiene el número de referencia asociado al mensaje de error concreto.
Error
  message : String
Contiene el mensaje asociado al objeto Error.
Error
  name : String
Contiene el nombre del objeto Error.
Error
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
Métodos públicos
 MétodoDefinido por
  
Error(message:String = "", id:int = 0)
Crea un nuevo objeto Error.
Error
  
Devuelve el apilamiento de llamada para un error como una cadena en el momento de la construcción del error (sólo para la versión del depurador de Flash Player).
Error
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Devuelve la cadena "Error" de manera predeterminada o el valor contenido en la propiedad Error.message, en el caso de que se haya definido.
Error
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
errorIDpropiedad
errorID:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Contiene el número de referencia asociado al mensaje de error concreto. En el caso de un objeto Error personalizado, este número es el valor del parámetro id proporcionado en el constructor.


Implementación
    public function get errorID():int
messagepropiedad 
public var message:String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Contiene el mensaje asociado al objeto Error. De manera predeterminada, el valor de esta propiedad es "Error". Puede especificar una propiedad message cuando cree un objeto Error pasando la cadena de error a la función constructora Error.

Véase también

namepropiedad 
public var name:String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Contiene el nombre del objeto Error. De manera predeterminada, el valor de esta propiedad es "Error".

Véase también

Información sobre constructores
Error()constructor
public function Error(message:String = "", id:int = 0)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un nuevo objeto Error. Si se especifica message, su valor se asigna a la propiedad Error.message del objeto.

Parámetros
message:String (default = "") — Una cadena asociada al objeto Error; este parámetro es opcional.
 
id:int (default = 0) — Un número de referencia que se asocia al mensaje de error en cuestión.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un nuevo objeto Error err y, a continuación, con el constructor Error(), se asigna la cadena a"New Error Message" en err.

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

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
Información sobre métodos
getStackTrace()método
public function getStackTrace():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve el apilamiento de llamada para un error como una cadena en el momento de la construcción del error (sólo para la versión del depurador de Flash Player). Como se muestra en el siguiente ejemplo, la primera línea del valor devuelto es la representación de cadena del objeto de excepción, seguido de los elementos de seguimiento de la pila:

  TypeError: null cannot be converted to an object
      at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
      at com.xyz.OrderEntry.init(OrderEntry.as:200)
      at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
     

Valor devuelto
String — Una representación de cadena del apilamiento de llamada.
toString()método 
public override function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve la cadena "Error" de forma predeterminada o el valor contenido en la propiedad Error.message, si está definida.

Valor devuelto
String — El mensaje de error.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un nuevo objeto Error err y, a continuación, con el constructor Error(), se asigna la cadena a"New Error Message" en err. Por último, la propiedad message se define como "Another New Error Message", que sobrescribe "New Error Message".

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
Ejemplos Cómo utilizar los ejemplos
ErrorExample.as

El siguiente ejemplo utiliza la clase ErrorExample para ilustrar cómo se puede generar un error personalizado. Esto se consigue con los pasos siguientes:
  1. Se declara una variable local nullArray de tipo Array, pero observe que nunca se crea un nuevo objeto Array.
  2. El constructor intenta cargar un valor en la matriz sin inicializar mediante el método push() dentro del segmento de código de gestión de errores que detecta un error personalizado utilizando la clase CustomError, que amplía la clase Error.
  3. Cuando se emite CustomError, el constructor captura y envía un mensaje de error con la sentencia 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);
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Error.html