Package | flash.events |
Class | public class HTTPStatusEvent |
Inheritance | HTTPStatusEvent ![]() ![]() |
Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
HTTPStatusEvent.HTTP_STATUS
.
HTTPStatusEvent objects are always sent before error or completion events. An HTTPStatusEvent object does not necessarily indicate an error condition; it simply reflects the HTTP status code (if any) that is provided by the networking stack. Some Flash Player environments may be unable to detect HTTP status codes; a status code of 0 is always reported in these cases.
See also
Property | Defined By | ||
---|---|---|---|
![]() | bubbles : Boolean [read-only] Indicates whether an event is a bubbling event. | Event | |
![]() | cancelable : Boolean [read-only] Indicates whether the behavior associated with the event can be prevented. | Event | |
![]() | constructor : Object A reference to the class object or constructor function for a given object instance. | Object | |
![]() | currentTarget : Object [read-only] The object that is actively processing the Event object with an event listener. | Event | |
![]() | eventPhase : uint [read-only] The current phase in the event flow. | Event | |
![]() | prototype : Object [static] A reference to the prototype object of a class or function object. | Object | |
status : int [read-only] The HTTP status code returned by the server. | HTTPStatusEvent | ||
![]() | target : Object [read-only] The event target. | Event | |
![]() | type : String [read-only] The type of event. | Event |
Method | Defined By | ||
---|---|---|---|
Creates an Event object that contains specific information about HTTP status events. | HTTPStatusEvent | ||
Creates a copy of the HTTPStatusEvent object and sets the value of each property to match that of the original. | HTTPStatusEvent | ||
![]() | A utility function for implementing the
toString() method in your custom Event class. | Event | |
![]() | Indicates whether an object has a specified property defined. | Object | |
![]() | Checks whether preventDefault() has been called on the event. | Event | |
![]() | Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
![]() | Cancels an event's default behavior if that behavior can be canceled. | Event | |
![]() | Indicates whether the specified property exists and is enumerable. | Object | |
![]() | Sets the availability of a dynamic property for loop operations. | Object | |
![]() | Prevents processing of any event listeners in the current node and any subsequent nodes in
the event flow. | Event | |
![]() | Prevents processing of any event listeners in nodes subsequent to the current node in the
event flow. | Event | |
Returns a string that contains all the properties of the HTTPStatusEvent object. | HTTPStatusEvent | ||
![]() | Returns the primitive value of the specified object. | Object |
Constant | Defined By | ||
---|---|---|---|
![]() | ACTIVATE : String = "activate" [static] Defines the value of the type property of an activate event object. | Event | |
![]() | ADDED : String = "added" [static] Defines the value of the type property of an added event object. | Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [static] Defines the value of the type property of an addedToStage event object. | Event | |
![]() | CANCEL : String = "cancel" [static] Defines the value of the type property of a cancel event object. | Event | |
![]() | CHANGE : String = "change" [static] Defines the value of the type property of a change event object. | Event | |
![]() | CLEAR : String = "clear" [static] Defines the value of the type property of a clear event object. | Event | |
![]() | CLOSE : String = "close" [static] Defines the value of the type property of a close event object. | Event | |
![]() | COMPLETE : String = "complete" [static] Defines the value of the type property of a complete event object. | Event | |
![]() | CONNECT : String = "connect" [static] Defines the value of the type property of a connect event object. | Event | |
![]() | COPY : String = "copy" [static] Defines the value of the type property of a copy event object. | Event | |
![]() | CUT : String = "cut" [static] Defines the value of the type property of a cut event object. | Event | |
![]() | DEACTIVATE : String = "deactivate" [static] Defines the value of the type property of a deactivate event object. | Event | |
![]() | ENTER_FRAME : String = "enterFrame" [static] Defines the value of the type property of an enterFrame event object. | Event | |
![]() | EXIT_FRAME : String = "exitFrame" [static] Defines the value of the type property of an exitFrame event object. | Event | |
![]() | FRAME_CONSTRUCTED : String = "frameConstructed" [static] Defines the value of the type property of an frameConstructed event object. | Event | |
![]() | FULLSCREEN : String = "fullScreen" [static] The Event.FULLSCREEN constant defines the value of the type property of a fullScreen event object. | Event | |
HTTP_STATUS : String = "httpStatus" [static] Defines the value of the type property of a httpStatus event object. | HTTPStatusEvent | ||
![]() | ID3 : String = "id3" [static] Defines the value of the type property of an id3 event object. | Event | |
![]() | INIT : String = "init" [static] Defines the value of the type property of an init event object. | Event | |
![]() | MOUSE_LEAVE : String = "mouseLeave" [static] Defines the value of the type property of a mouseLeave event object. | Event | |
![]() | OPEN : String = "open" [static] Defines the value of the type property of an open event object. | Event | |
![]() | PASTE : String = "paste" [static] Defines the value of the type property of a paste event object. | Event | |
![]() | REMOVED : String = "removed" [static] Defines the value of the type property of a removed event object. | Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [static] Defines the value of the type property of a removedFromStage event object. | Event | |
![]() | RENDER : String = "render" [static] Defines the value of the type property of a render event object. | Event | |
![]() | RESIZE : String = "resize" [static] Defines the value of the type property of a resize event object. | Event | |
![]() | SCROLL : String = "scroll" [static] Defines the value of the type property of a scroll event object. | Event | |
![]() | SELECT : String = "select" [static] Defines the value of the type property of a select event object. | Event | |
![]() | SELECT_ALL : String = "selectAll" [static] Defines the value of the type property of a selectAll event object. | Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [static] Defines the value of the type property of a soundComplete event object. | Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static] Defines the value of the type property of a tabChildrenChange event object. | Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static] Defines the value of the type property of a tabEnabledChange event object. | Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [static] Defines the value of the type property of a tabIndexChange event object. | Event | |
![]() | UNLOAD : String = "unload" [static] Defines the value of the type property of an unload event object. | Event |
status | property |
status:int
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
The HTTP status code returned by the server. For example, a value of 404 indicates that the server has not found a match for the requested URI. HTTP status codes can be found in sections 10.4 and 10.5 of the HTTP specification at ftp://ftp.isi.edu/in-notes/rfc2616.txt .
If Flash Player cannot get a status code from the server, or if it cannot communicate with the server, the default value of 0 is passed to your ActionScript code. A value of 0 can be generated in any player (for example, if a malformed URL is requested), and a value of 0 is always generated by the Flash Player plug-in when it is run in the following browsers, which do not pass HTTP status codes to the player: Netscape, Mozilla, Safari, Opera, and Internet Explorer for the Macintosh.
public function get status():int
HTTPStatusEvent | () | Constructor |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)
Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
Creates an Event object that contains specific information about HTTP status events. Event objects are passed as parameters to event listeners.
Parameterstype:String —
The type of the event. Event listeners can access this information through the inherited
type
property. There is only one type of HTTPStatus event:
HTTPStatusEvent.HTTP_STATUS
.
| |
bubbles:Boolean (default = false ) —
Determines whether the Event object participates in the bubbling stage of the event flow. Event listeners can access this information through the inherited
bubbles
property.
| |
cancelable:Boolean (default = false ) —
Determines whether the Event object can be canceled. Event listeners can access this information through the inherited
cancelable
property.
| |
status:int (default = 0 ) —
Numeric status. Event listeners can access this information through the
status
property.
|
See also
clone | () | method |
override public function clone():Event
Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
Creates a copy of the HTTPStatusEvent object and sets the value of each property to match that of the original.
ReturnsEvent — A new HTTPStatusEvent object with property values that match those of the original. |
toString | () | method |
override public function toString():String
Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
Returns a string that contains all the properties of the HTTPStatusEvent object. The string is in the following format:
[HTTPStatusEvent type=
value
bubbles=
value
cancelable=
value
status=
value
]
String — A string that contains all the properties of the HTTPStatusEvent object. |
HTTP_STATUS | Constant |
public static const HTTP_STATUS:String = "httpStatus"
Language Version: | ActionScript 3.0 |
Runtime Versions: | 1.0, 9 |
Defines the value of the
type
property of a
httpStatus
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles
|
false
|
cancelable
|
false
; there is no default behavior to cancel.
|
currentTarget
| The object that is actively processing the Event object with an event listener. |
status
| The HTTP status code returned by the server. |
target
| The network object receiving an HTTP status code. |
See also
httpStatusHandler
event with a status of 404, indicating that
the file was not found. The
httpStatusHandler
event is handled by
httpStatusHandler()
,
which simply prints two lines of information about the event.
Notes:
securityError
event in this example.
httpStatusHandler
event with status code 0 instead of 404.
httpStatusHandler
event.
package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.HTTPStatusEvent; public class HTTPStatusEventExample extends Sprite { public function HTTPStatusEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html"); loader.load(request); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); trace("status: " + event.status); } } }