Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
También puede crear una subclase de la clase Error y emitir instancias de dicha subclase.
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
errorID : int [solo lectura]
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 |
Método | Definido por | ||
---|---|---|---|
Crea un nuevo objeto Error. | Error | ||
Devuelve la pila de llamadas de un error en el momento de la construcción del error como una cadena. | Error | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
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 | ||
Devuelve el valor simple del objeto especificado. | Object |
errorID | propiedad |
errorID:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
message | propiedad |
public var message:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
Elementos de API relacionados
name | propiedad |
public var name:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene el nombre del objeto Error. De manera predeterminada, el valor de esta propiedad es "Error
".
Elementos de API relacionados
Error | () | Información sobre |
public function Error(message:String = "", id:int = 0)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuevo objeto Error. Si se especifica message
, su valor se asigna a la propiedad Error.message
del objeto.
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.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
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
getStackTrace | () | método |
public function getStackTrace():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve la pila de llamadas de un error en el momento de la construcción del error como una cadena. 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: 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]
El listado anterior muestra el valor de este método cuando se le llama en una versión de depuración de Flash Player o de código que se ejecuta en AIR Debug Launcher (ADL). Cuando el código se ejecuta en la versión de lanzamiento de Flash Player o AIR, el seguimiento de pila se proporciona sin la ruta de archivo ni la información del número de línea, tal como se muestra en el siguiente ejemplo:
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()
Para Flash Player 11.4 y versiones anteriores, y en AIR 3.4 y versiones anteriores, los seguimientos de pila solo están disponibles cuando el código se ejecuta en la versión de depuración de Flash Player o en AIR Debug Launcher (ADL). En versiones sin depuración de esos motores, llamar a este método devuelve null
.
String — Una representación de cadena del apilamiento de llamada.
|
toString | () | método |
override public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve la cadena "Error"
de forma predeterminada o el valor contenido en la propiedad Error.message
, si está definida.
String — El mensaje de error.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
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
ErrorExample
para ilustrar cómo se puede generar un error personalizado. Esto se consigue con los pasos siguientes:
- Se declara una variable local
nullArray
de tipo Array, pero observe que nunca se crea un nuevo objeto Array. - El constructor intenta cargar un valor en el conjunto 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 claseCustomError
, que amplía la claseError
. - 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); } }
Tue Jun 12 2018, 02:12 PM Z