ActionScript 3.0 Language and Components Reference | All Packages | All Classes | Language Elements | Index | Appendixes | Conventions | Frames No Frames |
ScriptTimeoutError

Package | flash.errors
Class | public dynamic class ScriptTimeoutError
Inheritance | ScriptTimeoutError Error Object

Language Version : | ActionScript 3.0

Player Version : | Flash Player 9

The ScriptTimeoutError exception is thrown when the script timeout interval is reached. The script timeout interval is 15 seconds.

Two ScriptTimeoutError exceptions are thrown. The first exception you can catch and exit cleanly. If there is no exception handler, the uncaught exception terminates execution. The second exception is thrown but cannot be caught by user code; it goes to the uncaught exception handler. It is uncatchable to prevent Flash® Player from hanging indefinitely.

View the examples

See also

flash.error package Error classes

Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | constructor : Object A reference to the class object or constructor function for a given object instance. | Object
|  | errorID : int [read-only] Contains the reference number associated with the specific error message. | Error
|  | message : String Contains the message associated with the Error object. | Error
|  | name : String Contains the name of the Error object. | Error
|  | prototype : Object [static] A reference to the prototype object of a class or function object. | Object

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | ScriptTimeoutError(message:String = "") Creates a new ScriptTimeoutError object. | ScriptTimeoutError
|  | getStackTrace():String Returns the call stack for an error as a string at the time of the error's construction (for the debugger version of Flash Player only). | Error
|  | hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined. | Object
|  | isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. | Object
|  | propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable. | Object
|  | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations. | Object
|  | toString():String Returns the string "Error" by default or the value contained in Error.message property, if defined. | Error
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Constructor Detail

ScriptTimeoutError | () | Constructor

`public function ScriptTimeoutError(message:String = "")`

Language Version : | ActionScript 3.0

Player Version : | Flash Player 9

Creates a new ScriptTimeoutError object.

Parameters

| `message:String` (default = "``")`` — A string associated with the error object.

Examples How to use examples
ScriptTimeoutErrorExample.as
The following example uses the sample ScriptTimeoutErrorExample class to show the error generated in the event of script timeout. This is accomplished with the following steps:

1. A `keepLooking` Boolean property is declared.
2. The constructor calls the `lockMachine()` method within an error handling code segment that catches ScriptTimeoutError objects.
3. The `lockMachine()` method contains an endless `while` loop.
4. After awhile, the ScriptTimeoutError is thrown. The constructor catches it, outputs an error message through the `trace` statement and resets the `keepLooking` Boolean to `false`, which terminates the `while` loop in `lockMachine()`.

    package {
        import flash.display.Sprite;
        import flash.errors.ScriptTimeoutError;

        public class ScriptTimeoutErrorExample extends Sprite {
            private var keepLooping:Boolean = true;

            public function ScriptTimeoutErrorExample() {
                try {
                    lockMachine();
                }
                catch(e:ScriptTimeoutError) {
                    trace(e);    // ScriptTimeoutError: Error #1502: A script has executed for longer than 15 seconds
                    keepLooping = false;
                }
            }

            private function lockMachine():void {
                while(keepLooping){
                }
            }
        }
    }

Submit Feedback on LiveDocs
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Tue May 20 2008, 04:02 AM -07:00