| 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 |
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.
More examples
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
| Method | Defined By | ||
|---|---|---|---|
SecurityError(message:String = "")
Creates a new SecurityError object. | SecurityError | ||
|
Returns the call stack for an error at the time of the error's
construction as a string. | Error | |
|
Indicates whether an object has a specified property defined. | Object | |
|
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
|
Indicates whether the specified property exists and is enumerable. | Object | |
|
Sets the availability of a dynamic property for loop operations. | Object | |
|
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
| [override]
Returns the string "Error" by default or the value contained in the Error.message property,
if defined. | Error | |
|
Returns the primitive value of the specified object. | Object | |
Constructor Detail
SecurityError | () | Constructor |
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.
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);
}
}
}
}
Thu Dec 4 2014, 05:50 PM -08:00