Clases Error principales de ECMAScript

Error

La clase Error puede usarse para generar excepciones. Es la clase base para otras clases de excepción definidas en ECMAScript: EvalError, RangeError, ReferenceError, SyntaxError, TypeError y URIError.

La clase Error es la clase base para todos los errores en tiempo de ejecución que genera Flash Player. Asimismo, es la clase base recomendada para cualquier clase de error personalizada.

EvalError

La excepción EvalError se genera si se pasan parámetros al constructor de la clase Function, o bien si el código del usuario llama a la función eval().

En ActionScript 3.0, se ha eliminado la compatibilidad con la función eval(); los intentos de usar dicha función generarán errores.

Las versiones anteriores de Flash Player utilizaban la función eval() para acceder a variables, propiedades, objetos o clips de película por su nombre.

RangeError

Se genera una excepción RangeError si un valor numérico queda fuera del rango admitido.

Por ejemplo, la clase Timer generará una excepción RangeError si la demora es negativa o no finita. También se puede generar RangeError si se intenta añadir un objeto de visualización a una profundidad no válida.

ReferenceError

Se emite una excepción ReferenceError cuando se intenta realizar una referencia a una propiedad no definida en un objeto cerrado (no dinámico). Las versiones del compilador de ActionScript anteriores a ActionScript 3.0 no generaban errores al intentar acceder a una propiedad undefined. Sin embargo, puesto que la nueva especificación ECMAScript determina que debe generarse un error en esta situación, ActionScript 3.0 genera la excepción ReferenceError.

Las excepciones para variables no definidas señalan errores potenciales, lo que ayuda a mejorar la calidad del software. Sin embargo, si el usuario no está acostumbrado a inicializar las variables, es posible que este nuevo comportamiento de ActionScript requiera cambios en sus hábitos de programación.

SyntaxError

Se genera una excepción SyntaxError cuando se produce un error de análisis en el código de ActionScript.

Para más información, consulte la sección 15.11.6.4 de la especificación del lenguaje ECMAScript (ECMA-262) edición 3 (disponible hasta la edición 4) en www.ecma-international.org/publications/standards/Ecma-262.htm, así como la sección 10.3.1 de la especificación ECMAScript for XML (E4X, ECMA-357, edición 2) en www.ecma-international.org/publications/standards/Ecma-357.htm.

Se puede generar SyntaxError en las circunstancias siguientes:

• ActionScript emite excepciones SyntaxError cuando la clase RegExp analiza una expresión normal no válida.
• Genera excepciones SyntaxError cuando la clase XMLDocument analiza código XML no válido.

TypeError

Se genera la excepción TypeError cuando el tipo real de un operando es diferente del tipo esperado.

Para más información, consulte la sección 15.11.6.5 de la especificación ECMAScript en www.ecma-international.org/publications/standards/Ecma-262.htm, así como la sección 10.3 de la especificación E4X en www.ecma-international.org/publications/standards/Ecma-357.htm.

Se puede generar una excepción TypeError en las circunstancias siguientes:

• No se ha podido forzar el tipo de parámetro formal de un parámetro real de una función o un método.
• Se ha asignado un valor a una variable y no se puede forzar el tipo de la variable.
• El lado derecho del operador is o instanceof no es un tipo válido.
• La palabra clave super se utiliza de manera no permitida.
• Una consulta de propiedad da como resultado más de una vinculación y, por consiguiente, resulta ambigua.
• Se ha invocado un método en un objeto incompatible. Por ejemplo, se genera una excepción TypeError si se inserta un método de la clase RegExp en un objeto genérico y luego se invoca.

URIError

Se genera la excepción URIError cuando una de las funciones de gestión de URI global se utiliza de manera incompatible con esta definición.

Para más información, consulte la sección 15.11.6.6 de la especificación ECMAScript en www.ecma-international.org/publications/standards/Ecma-262.htm.

Se puede generar una excepción URIError en las circunstancias siguientes:

Se especifica un URI no válido para una función de la API de Flash Player que espera un URI válido, como Socket.connect().