Top Level

# SecurityError - AS3

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

Language Version: | ActionScript 3.0

Runtime Versions: | Flash Player 9, AIR 1.0, Flash Lite 4

The `SecurityError` exception is thrown when some type of security violation takes place.

Examples of security errors:

- An unauthorized property access or method call is made across a security sandbox boundary.
- An attempt was made to access a URL not permitted by the security sandbox.
- A socket connection was attempted to an unauthorized port number, e.g. a port above 65535.
- An attempt was made to access the user's camera or microphone, and the request to access the device was denied by the user.

View the examples

More examples

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

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | SecurityError(message:String = "") Creates a new SecurityError object. | SecurityError
|  | getStackTrace():String Returns the call stack for an error at the time of the error's construction as a string. | 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
|  | toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions. | Object
|  | toString():String [override] Returns the string "Error" by default or the value contained in the Error.message property, if defined. | Error
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Constructor Detail

### SecurityError

()
Constructor

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

Runtime Versions: | Flash Lite 4, Flash Player 9, AIR 1.0

Creates a new SecurityError object.

Parameters

| `message:String` (default = "``")``

Examples How to use this example
SecurityErrorExample.as
The following example shows how a `SecurityError` error can be generated and handled within a `try...catch` statement by attempting to connect to a port number that is one larger than the maximum allowed.
Copy

    package {
        import flash.display.Sprite;
        import flash.net.Socket;

        public class SecurityErrorExample extends Sprite {

            public function SecurityErrorExample() {
                try {
                    var host:String = "www.[yourDomain].com";
                    var socket:Socket = new Socket();
                    socket.connect(host, 65536);
                }
                catch(e:SecurityError) {
                    trace(e);
                }
            }
        }
    }

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00