[mootools] XHR.js

/*
Script: XHR.js
 Contains the basic XMLHttpRequest Class Wrapper.

License:
 MIT-style license.
*/

/*
Class: XHR
 Basic XMLHttpRequest Wrapper.

Arguments:
 options - an object with options names as keys. See options below.

Options:
 method - 'post' or 'get' - the protocol for the request; optional, defaults to 'post'.
 async - boolean: asynchronous option; true uses asynchronous requests. Defaults to true.
 encoding - the encoding, defaults to utf-8.
 autoCancel - cancels the already running request if another one is sent. defaults to false.
 headers - accepts an object, that will be set to request headers.
 
Events:
 onRequest - function to execute when the XHR request is fired.
 onSuccess - function to execute when the XHR request completes.
 onStateChange - function to execute when the state of the XMLHttpRequest changes.
 onFailure - function to execute when the state of the XMLHttpRequest changes.

Properties:
 running - true if the request is running.
 response - object, text and xml as keys. You can access this property in the onSuccess event.

Example:
 >var myXHR = new XHR({method: 'get'}).send('http://site.com/requestHandler.php', 'name=john&lastname=dorian');
*/