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

Package | Top Level
Class | public dynamic class TypeError
Inheritance | TypeError Error Object

Language Version : | ActionScript 3.0

Player Version : | Flash Player 9

A TypeError exception is thrown when the actual type of an operand is different from the expected type.

In addition, this exception is thrown when:

- An actual parameter to a function or method could not be coerced to the formal parameter type.
- A value is assigned to a variable and cannot be coerced to the variable's type.
- The right side of the `is` or `instanceof` operator is not a valid type.
- The `super` keyword is used illegally.
- A property lookup results in more than one binding, and is therefore ambiguous.
- A method is invoked on an incompatible object. For example, a TypeError exception is thrown if a RegExp class method is "grafted" onto a generic object and then invoked.

View the examples

See also

is operator
instanceof operator
super statement
RegExp class
Responding to error events and status

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
--- | --- | ---
|  | TypeError(message:String = "") Creates a new TypeError object. | TypeError
|  | 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

TypeError | () | Constructor

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

Creates a new TypeError object.

Parameters

| `message:String` (default = "``")`` — Contains the message associated with the TypeError object.

See also

Responding to error events and status
Examples How to use examples
TypeErrorExample.as
The following example shows how a TypeError exception can be generated and handled within a `try..catch` statement.

    package {
        import flash.display.DisplayObject;
        import flash.display.Sprite;

        public class TypeErrorExample extends Sprite {
            public function TypeErrorExample() {
                try {
                    var child:Object = new Object();
                    addChild(DisplayObject(child));
                }
                catch(e:TypeError) {
                    trace(e);
                }
            }
        }
    }

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