Shayton Equilibrium Kitchen Utensil 2003 User Manual

24 

 Chapter 3 

• 

• 

• 

•

•

Most MediaScript functions indicate an error condition by throwing an exception rather 
than returning an error code. Exceptions can be trapped and handled using ECMAScript's 
standard try/catch/finally mechanism.

For example, the Media object's load() method throws an exception if the file to be loaded 
is not found. To trap this exception, you would write something like the following:

try

{

    img.load(name @ "missingFile.tga");

}

catch (e)

{

    // Here you can recover from the error.  Possible

    // actions include loading a default image, 

    // logging an error, or returning a 404.

}

If an exception is thrown while executing your script and no catch block traps it, the script 
will terminate immediately. By default the error is logged to the ScriptErrors.log file 
and returned to the client as an error response. You can disable logging by setting the 
ScriptErrorLogging

 property to false in the global.properties configuration file. 

For HTTP clients, you can disable the returning of the error response as HTML by setting 
the ReturnHtmlErrors property to false in global.properties. If error HTML is disabled 
MediaRich will respond with a 500 Internal Server Error status code.

The File object provides access to an external file.