throw

Disponibilidad

Flash Player 7.

Sintaxis

throw expression

Descripción

Sentencia; genera (emite) un error que puede controlarse (detectarse) mediante un bloque de código catch{} o finally{}. Si un bloque catch o finally no detecta una excepción, la representación de cadena del valor emitido se envía al panel Salida.

Generalmente, se emiten instancias de la clase Error o de sus subclases (consulte los ejemplos que aparecen a continuación).

Parámetros

expression Expresión u objeto de ActionScript.

Ejemplo

En este ejemplo, una función denominada checkEmail() comprueba si la cadena que se le ha pasado es una dirección de correo electrónico con un formato correcto. Si la cadena no contiene el símbolo @, la función emite un error.

function checkEmail(email:String) {
  if (email.indexOf("@") == -1) {
    throw new Error("Dirección de correo electrónico incorrecta");
  }
}

En el código siguiente se llama a la función checkEmail() en el bloque de código try y se pasa el texto de un campo de texto (email_txt) como parámetro. Si el parámetro de cadena no contiene una dirección de correo electrónico válida, el mensaje de error se muestra en un campo de texto (error_txt).

try {
  checkEmail("Joe Smith");
} catch (e) {
  error_txt.text = e.toString();
}

En este ejemplo, se emite una subclase de la clase Error. La función checkEmail() se modifica para emitir una instancia de dicha subclase. Para más información, consulte Creación de subclases.

// Definir la subclase Error denominada InvalidEmailError
// En InvalidEmailError.as:
class InvalidEmailAddress extends Error {
  var message = "Dirección de correo incorrecta.";
}
function checkEmail(email:String) {
  if (email.indexOf("@") == -1) {
    throw new InvalidEmailAddress();
  }
}

Véase también

Clase Error, try..catch..finally