Documentación de Flash CS3

Programación con ActionScript 3.0 > Gestión de errores > Fundamentos de la gestión de errores

Fundamentos de la gestión de errores

Introducción a la gestión de errores

Un error en tiempo de ejecución es algo que no funciona en el código ActionScript y que impide la ejecución de su contenido en Adobe Flash Player. Para asegurarse de que los usuarios pueden ejecutar correctamente el código ActionScript, se debe añadir a la aplicación código para gestionar errores, es decir, para corregirlos o al menos indicar al usuario qué ha sucedido. Este proceso se denomina gestión de errores.

La gestión de errores es un campo amplio que incluye respuestas a muchas clases de errores generados durante la compilación o en tiempo de ejecución. Los errores que se producen en tiempo de compilación suelen ser más fáciles de identificar; se deben corregir para completar el proceso de creación de un archivo SWF. En este capítulo no se tratan los errores en tiempo de compilación; para más información sobre cómo escribir código que no contenga errores en tiempo de compilación, consulte El lenguaje ActionScript y su sintaxis y el Programación orientada a objetos con ActionScript. Este capítulo se centra en los errores en tiempo de ejecución.

La detección de errores en tiempo de ejecución puede resultar más difícil, ya que para que se produzcan, el código debe ejecutarse. Si un segmento del programa tiene varias ramas de código, como una sentencia if..then..else, se deben probar todas las condiciones posibles, con todos los valores de entrada posibles que podrían utilizar los usuarios reales, para confirmar que el código no presenta errores.

Los errores en tiempo de ejecución se pueden dividir en dos categorías: los errores de programa son errores del código ActionScript, como la especificación del tipo de datos incorrecto para un parámetro de método; los errores lógicos son errores de la lógica (la comprobación de datos y la manipulación de valores) del programa, como la utilización de la fórmula incorrecta para calcular tipos de interés en una aplicación bancaria. Los dos tipos de error pueden detectarse y corregirse si se prueba la aplicación minuciosamente.

Lo ideal sería que se identificaran y se eliminaran todos los errores de la aplicación antes de que pasara a disposición de los usuarios finales. Sin embargo, no todos los errores pueden predecirse o evitarse. Por ejemplo, imagine que la aplicación ActionScript carga información de un sitio Web determinado que se encuentra fuera de su control. Si en algún momento dicho sitio no está disponible, la parte de la aplicación que depende de los datos externos no se comportará correctamente. El aspecto más importante de la gestión de errores implica prepararse para estos casos desconocidos, así como gestionarlos adecuadamente para que los usuarios puedan seguir utilizando la aplicación, o al menos obtengan un mensaje de error claro que indique por qué no funciona.

Los errores en tiempo de ejecución se representan de dos formas en ActionScript:

Clases de error: muchos errores tienen una clase de error asociada a ellos. Cuando se produce un error, Flash Player crea una instancia de la clase de error específica asociada a dicho error. El código puede utilizar información contenida en ese objeto de error para generar una respuesta adecuada al error.
Eventos de error: a veces, el error se produce cuando Flash Player activa normalmente un evento. En estos casos, Flash Player desencadena un evento de error. Al igual que en otros eventos, cada evento de error tiene una clase asociada y Flash Player pasa una instancia de dicha clase a los métodos que están suscritos al evento de error.

Para determinar si un método concreto puede desencadenar un error o un evento de error, consulte la entrada del método en la Referencia del lenguaje y componentes ActionScript 3.0.

Tareas comunes de la gestión de errores

A continuación se describen tareas comunes relativas a errores que posiblemente se deban realizar con el código:

Escribir código para gestionar errores
Probar errores, detectarlos y volverlos a emitir
Definir una clase de error personalizada
Responder al error y a los eventos de error

Conceptos y términos importantes

La siguiente lista de referencia contiene términos importantes que se utilizan en este capítulo:

Asincrónico: comando de programa, como una llamada de método que no proporciona un resultado inmediato; en su lugar, origina un resultado (o error) en forma de evento.
Capturar: cuando se produce una excepción (un error en tiempo de ejecución) y el código la reconoce, se dice que el código captura la excepción. Una vez que se captura la excepción, Flash Player deja de notificar la excepción a otro código ActionScript.
Versión de depuración: versión especial de Flash Player que contiene código para notificar los errores en tiempo de ejecución a los usuarios. En la versión estándar de Flash Player (la que tienen la mayoría de los usuarios), se omiten los errores no gestionados por el código ActionScript. En la versión de depuración (que se incluye en Adobe Flash CS3 Professional y Adobe Flex), aparece un mensaje de advertencia cuando se produce un error no gestionado.
Excepción: error que se produce cuando se ejecuta un programa y que el entorno en tiempo de ejecución (es decir, Flash Player) no puede resolver por sí mismo.
Volver a emitir: cuando el código captura una excepción, Flash Player deja de notificar la excepción a otros objetos. Si resulta importante notificar la excepción a otros objetos, el código debe volver a emitir la excepción para que se vuelva a iniciar el proceso de notificación.
Sincrónico: comando de programa, como una llamada de método, que proporciona un resultado inmediato (o emite inmediatamente un error), lo que implica que la respuesta puede utilizarse con el mismo bloque de código.
Emitir: el acto de notificar a Flash Player (y, en consecuencia, notificar a otros objetos y al código ActionScript) que se ha producido un error, se conoce como emitir un error.

Ejecución de los ejemplos del capítulo

A medida que progresa en el estudio del capítulo, es posible que desee probar algunos de los listados de código. Prácticamente todos los listados de código de este capítulo incluyen la llamada a la función trace() apropiada. Para probar los listados de código de este capítulo:

Cree un documento de Flash vacío.
Seleccione un fotograma clave en la línea de tiempo.
Abra el panel Acciones y copie el listado de código en el panel Script.
Ejecute el programa seleccionando Control > Probar película.
El resultado de las funciones trace() del código se ve en el panel Salida.

Algunos de los últimos ejemplos de código son más complejos y se han programado como una clase. Para probar estos ejemplos:

Cree un documento de Flash vacío y guárdelo en el equipo.
Cree un nuevo archivo de ActionScript y guárdelo en el mismo directorio que el documento de Flash. El nombre del archivo debe coincidir con el nombre de la clase del listado de código. Por ejemplo, si el listado de código define una clase denominada ErrorTest, use el nombre ErrorTest.as para guardar el archivo de ActionScript.
Copie el listado de código en el archivo de ActionScript y guarde el archivo.
En el documento de Flash, haga clic en una parte vacía del escenario o espacio de trabajo para activar el inspector de propiedades del documento.
En el inspector de propiedades, en el campo Clase de documento, escriba el nombre de la clase de ActionScript que copió del texto.
Ejecute el programa seleccionando Control > Probar película.
Verá el resultado del ejemplo en el panel Salida (si se utiliza la función trace() en el código del ejemplo) o en un campo de texto creado por el código del ejemplo.

Estas técnicas para probar listados de código de ejemplo se describen de forma más detallada en Prueba de los listados de código de ejemplo del capítulo.

Flash CS3

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/main/00000096.html