SecurityError (ActionScript 3.0)

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

Language version:

ActionScript 3.0

Runtime version:

AIR 1.0

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.

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 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
		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 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 version:

AIR 1.0

Creates a new SecurityError object.

Parameters

message:String (default = "")

Examples

examples\SecurityErrorExample

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.

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);
			}
		}
	}
}

Submit Feedback

ActionScript 3.0 Language Reference	All Packages \| All Classes \| Language Elements \| Index \| Appendices \| Conventions \| Frames No Frames
Class SecurityError	Properties \| Methods \| Examples