class openfl.events.ErrorEvent extends TextEvent

Available on all platforms

Sub classes
IOErrorEvent, SecurityErrorEvent
IOErrorEvent

An IOErrorEvent object is dispatched when an error causes input or output operations to fail.

SecurityErrorEvent

An object dispatches a SecurityErrorEvent object to report the occurrence of a security error. Security errors reported through this class are generally from asynchronous operations, such as loading data, in which security violations may not manifest immediately. Your event listener can access the object's text property to determine what operation was attempted and any URLs that were involved. If there are no event listeners, the debugger version of Flash Player or the AIR Debug Launcher (ADL) application automatically displays an error message that contains the contents of the text property. There is one type of security error event: SecurityErrorEvent.SECURITY_ERROR.

An object dispatches an ErrorEvent object when an error causes an asynchronous operation to fail.

The ErrorEvent class defines only one type of error event: ErrorEvent.ERROR. The ErrorEvent class also serves as the base class for several other error event classes, including the AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent, and UncaughtErrorEvent classes.

You can check for error events that do not have any listeners by registering a listener for the uncaughtError (UncaughtErrorEvent.UNCAUGHT_ERROR) event.

An uncaught error also causes an error dialog box displaying the error event to appear when content is running in the debugger version of Flash Player or the AIR Debug Launcher(ADL) application.

Class Fields

static var ERROR:String

Defines the value of the type property of an error event object.

This event has the following properties:

Instance Fields

var errorID:Int

Contains the reference number associated with the specific error. For a custom ErrorEvent object, this number is the value from the id parameter supplied in the constructor.

function new(type:String, ?bubbles:Bool = false, ?cancelable:Bool = false, ?text:String = '', ?id:Int = 0):Void

Creates an Event object that contains information about error events. Event objects are passed as parameters to event listeners.

type

The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR.

bubbles

Determines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property.

cancelable

Determines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property.

text

Text to be displayed as an error message. Event listeners can access this information through the text property.

id

A reference number to associate with the specific error (supported in Adobe AIR only).

function clone():Event

function toString():String