contents   index   previous   next

interface: SEErrorFunction


public void seAtErrorFunc(SEContext context, SEAtErrorInfo info);



The seAtErrorFunc method is invoked whenever a script generates an error, at the point of error. This will occur for any error, even if the error is trapped via a try/catch handler. Note that some scripts will throw errors as a valid part of their program such as to indicate an error return from a function which will be trapped higher up in the script. This is why normally you do not care about an error until it comes back to you via the sePrintErrorFunc, indicating it never is trapped. Getting an immediate notification is primarily useful in implementing a debugger for which the user may want to stop anytime an error is generated even if it will be handled, in order to step through the handling code.


The seAtErrorFunc is passed an informational SEAtErrorInfo object. Currently, the SEAtErrorInfo has one public method:


public boolean getTrapped();


The getTrapped method returns true if the error will be trapped and false if the sePrintErrorFunc will be called on it.


The actual value of the error is set up in the SE.RETURN object, described fully in Chapter V. For an error, the value is an Error object as described by the ECMAScript specification. Since working with variables and return values is not described until later chapters, you should revisit this description once you have read those chapters.




interface: SEContinueFunction