User Guide

XML 1303
See also
onLoad (XML.onLoad handler)
onHTTPStatus (XML.onHTTPStatus handler)
onHTTPStatus = function(httpStatus:Number) {}
Invoked when Flash Player receives an HTTP status code from the server. This handler lets
you capture and act on HTTP status codes.
The
onHTTPStatus handler is invoked before onData, which triggers calls to onLoad with a
value of
undefined if the load fails. It's important to note that after onHTTPStatus is
triggered,
onData is always subsequently triggered, regardless of whether or not you override
onHTTPStatus. To best use the onHTTPStatus handler, write an appropriate function to
catch the result of the
onHTTPStatus call; you can then use the result in your onData or
onLoad handler functions. If onHTTPStatus is not invoked, this indicates that the player did
not try to make the URL request. This can happen because the request violates security
sandbox rules for the SWF.
If Flash Player cannot get a status code from the server or if Flash Player 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, such as if a malformed URL is requested, and is always generated by
the Flash Player plug-in when run in the following browsers, which do not pass HTTP status
codes to the player: Netscape, Mozilla, Safari, Opera, or Internet Explorer for the Macintosh.
Availability: ActionScript 1.0; Flash Player 8
Parameters
httpStatus:Number - The HTTP status code returned by the server. For example, a value of
404 indicates that the server has not found anything matching 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.
Example
The following example shows how to use the
onHTTPStatus method to help with debugging.
The example collects HTTP status codes and assigns their value and type to an instance of the
XML object (notice that this example creates the instance members this.httpStatus and
this.httpStatusType at runtime). The onData method uses these to trace information
about the HTTP response that could be useful when debugging.
var myXml:XML = new XML();
myXml.onHTTPStatus = function(httpStatus:Number) {