Home » Development Area » DigiGuide Listings Grabber » API Index » Class: XMLHttpRequest

Class: XMLHttpRequest

Summary

Remarks

Methods

Method Description  abort Abort the current download  getAllResponseHeaders Get all of the HTTP response headers sent from the server  getResponseHeader Get a specific HTTP response header value  open Open a connection to use to make our requests.  send Start the request  setRequestHeader Set a request header to send to the server.

Events

Event Description  onreadystatechange Override this to be notified when the state of the request changes. Because we don't yet support async this is not needed.

Properties

Property Description  readyState The state of the request. Value Action 0 uninitialized 1 open 2 sent 3 receiving 4 loaded  responseBody A string containing the response from the request. This might be binary data.  responseText String containing the response from the server. This is the plain text version.  responseXML String containing the response from the server. This is the XML version. Note that this returns the exact same content as responseText as we don't support XML directly.  status HTTP return status of the request.  statusText Text description of the status.

Examples

var client = new XMLHttpRequest(); client.open("GET", "http://www.digiguide.com/i/nav/banner_gradient.gif", false ); var mail = new File( this.dataFolder + "banner_gradient.gif" ); if( mail.exists ) { mail.open( "read", "text" ) client.setRequestHeader( "If-Modified-Since", mail.lastModified.toUTCString() ); mail.close(); } client.send(""); if( client.status == "200" ) { var mail = new File( this.dataFolder + "banner_gradient2.gif" ); mail.open( "readWrite,replace,create", "text" ); mail.write( client.responseBody ); mail.close(); } else if( client.status == "304" ) { lp.writeLog( "Not modified since: " + client.getResponseHeader( "last-modified" ) ); } else { alert( "Failed with error " + client.status + " " + client.statusText ); return false; }

See Also