User Guide

Error.toString() 289

Error.name

Availability

Flash Player 7.

Usage

myError.name:String

Description

Property; contains the name of the Error object. By default, the value of this property is "Error".

Example

In the following example, a function throws a specified error depending on the two numbers that

you try to divide:

function divideNumber(numerator:Number, denominator:Number):Number {

if (isNaN(numerator) || isNaN(denominator)) {

throw new Error("divideNum function requires two numeric parameters.");

} else if (denominator == 0) {

throw new DivideByZeroError();

}

return numerator/denominator;

}

try {

var theNum:Number = divideNumber(1, 0);

trace("SUCCESS! "+theNum);

// output: DivideByZeroError -> Unable to divide by zero.

} catch (e_err:DivideByZeroError) {

// divide by zero error occurred

trace(e_err.name+" -> "+e_err.toString());

} catch (e_err:Error) {

// generic error occurred

trace(e_err.name+" -> "+e_err.toString());

}

To add a custom error, add the following code to a .AS file called DivideByZeroError.as.

class DivideByZeroError extends Error {

var name:String = "DivideByZeroError";

var message:String = "Unable to divide by zero.";

}