All Implemented Interfaces:

Serializable, Cloneable, org.htmlunit.corejs.javascript.ConstProperties, org.htmlunit.corejs.javascript.debug.DebuggableObject, org.htmlunit.corejs.javascript.Scriptable, org.htmlunit.corejs.javascript.SymbolScriptable

public class XMLHttpRequest
extends XMLHttpRequestEventTarget 

Author:

Daniel Gredler, Marc Guillemot, Ahmed Ashour, Stuart Begg, Ronald Brill, Sebastian Cato, Frank Danek, Jake Cobb, Thorsten Wendelmuth, Lai Quang Duong, Sven Strickroth

See Also:

W3C XMLHttpRequest, Safari documentation, Serialized Form

• Nested Class Summary

  • Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator, org.htmlunit.corejs.javascript.ScriptableObject.LambdaGetterFunction, org.htmlunit.corejs.javascript.ScriptableObject.LambdaSetterFunction

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static int	DONE All the data has been received; the complete data is available in responseBody and responseText.
  static int	HEADERS_RECEIVED The send() method has been called, but the status and headers are not yet available.
  static int	LOADING Some data has been received.
  static int	OPENED The object has been created, but the send() method has not been called.
  static int	UNSENT The object has been created, but not initialized (the open() method has not been called).

  • Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

  • Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

    NOT_FOUND

• Constructor Summary

  Constructors

  Constructor and Description
  XMLHttpRequest () Creates a new instance.

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  void	abort () Cancels the current HTTP request.
  String	getAllResponseHeaders () Returns the labels and values of all the HTTP headers.
  org.htmlunit.corejs.javascript.Function	getOnreadystatechange () Returns the event handler that fires on ready state change.
  int	getReadyState () Returns the current state of the HTTP request.
  Object	getResponse ()
  String	getResponseHeader (String headerName) Retrieves the value of an HTTP header from the response body.
  String	getResponseText () Returns a string version of the data retrieved from the server.
  String	getResponseType ()
  Object	getResponseXML () Returns a DOM-compatible document object version of the data retrieved from the server.
  int	getStatus () Returns the numeric status returned by the server, such as 404 for "Not Found" or 200 for "OK".
  String	getStatusText () Returns the string message accompanying the status code, such as "Not Found" or "OK".
  int	getTimeout ()
  XMLHttpRequestUpload	getUpload () Returns the upload property.
  boolean	isWithCredentials () Returns the withCredentials property.
  void	jsConstructor () JavaScript constructor.
  void	open (String method, Object urlParam, Object asyncParam, Object user, Object password) Assigns the destination URL, method and other optional attributes of a pending request.
  void	overrideMimeType (String mimeType) Override the mime type returned by the server (if any).
  void	send (Object content) Sends the specified content to the server in an HTTP request and receives the response.
  void	setOnreadystatechange (org.htmlunit.corejs.javascript.Function readyStateChangeHandler) Sets the event handler that fires on ready state change.
  void	setRequestHeader (String name, String value) Sets the specified header to the specified value.
  void	setResponseType (String responseType) Sets the responseType property.
  void	setTimeout (int timeout) Sets the number of milliseconds a request can take before automatically being terminated.
  void	setWithCredentials (boolean withCredentials) Sets the withCredentials property.

  • Methods inherited from class org.htmlunit.javascript.host.xml.XMLHttpRequestEventTarget

    getOnabort, getOnerror, getOnload, getOnloadend, getOnloadstart, getOnprogress, getOntimeout, setOnabort, setOnerror, setOnload, setOnloadend, setOnloadstart, setOnprogress, setOntimeout

  • Methods inherited from class org.htmlunit.javascript.host.event.EventTarget

    addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, removeEventListener, setEventHandler

  • Methods inherited from class org.htmlunit.javascript.HtmlUnitScriptable

    clone, equivalentValues, get, getBrowserVersion, getClassName, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getWindow, getWindow, getWindowFromTopCallScope, getWithPreemption, has, hasInstance, initParentScope, makeScriptableFor, put, setClassName, setDomNode, setDomNode, setParentScope, setupPromise, setupRejectedPromise

  • Methods inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChangeForSlot, checkPropertyDefinition, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, get, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSuperProperty, getSuperProperty, getSuperProperty, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, put, putConst, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setPrototype, size

  • Methods inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

    createSlotMap

  • Methods inherited from class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • UNSENT

    public static final int UNSENT

    The object has been created, but not initialized (the open() method has not been called).

    See Also:

    Constant Field Values

  • OPENED

    public static final int OPENED

    The object has been created, but the send() method has not been called.

    See Also:

    Constant Field Values

  • HEADERS_RECEIVED

    public static final int HEADERS_RECEIVED

    The send() method has been called, but the status and headers are not yet available.

    See Also:

    Constant Field Values

  • LOADING

    public static final int LOADING

    Some data has been received.

    See Also:

    Constant Field Values

  • DONE

    public static final int DONE

    All the data has been received; the complete data is available in responseBody and responseText.

    See Also:

    Constant Field Values

• Constructor Detail

  • XMLHttpRequest

    public XMLHttpRequest()

    Creates a new instance.

• Method Detail

  • jsConstructor

    public void jsConstructor()

    JavaScript constructor.

    Overrides:

    jsConstructor in class XMLHttpRequestEventTarget

  • getReadyState

    public int getReadyState()

    Returns the current state of the HTTP request. The possible values are:

    • 0 = unsent
    • 1 = opened
    • 2 = headers_received
    • 3 = loading
    • 4 = done

    Returns:

    the current state of the HTTP request

  • getResponseType

    public String getResponseType()

    Returns:

    the responseType property

  • setResponseType

    public void setResponseType(String responseType)

    Sets the responseType property.

    Parameters:

    responseType - the responseType property.

  • getResponse

    public Object getResponse()

    Returns:

    returns the response's body content as an ArrayBuffer, Blob, Document, JavaScript Object, or DOMString, depending on the value of the request's responseType property.

  • getResponseText

    public String getResponseText()

    Returns a string version of the data retrieved from the server.

    Returns:

    a string version of the data retrieved from the server

  • getResponseXML

    public Object getResponseXML()

    Returns a DOM-compatible document object version of the data retrieved from the server.

    Returns:

    a DOM-compatible document object version of the data retrieved from the server

  • getStatus

    public int getStatus()

    Returns the numeric status returned by the server, such as 404 for "Not Found" or 200 for "OK".

    Returns:

    the numeric status returned by the server

  • getStatusText

    public String getStatusText()

    Returns the string message accompanying the status code, such as "Not Found" or "OK".

    Returns:

    the string message accompanying the status code

  • abort

    public void abort()

    Cancels the current HTTP request.

  • getAllResponseHeaders

    public String getAllResponseHeaders()

    Returns the labels and values of all the HTTP headers.

    Returns:

    the labels and values of all the HTTP headers

  • getResponseHeader

    public String getResponseHeader(String headerName)

    Retrieves the value of an HTTP header from the response body.

    Parameters:

    headerName - the (case-insensitive) name of the header to retrieve

    Returns:

    the value of the specified HTTP header

  • open

    public void open(String method,
     Object urlParam,
     Object asyncParam,
     Object user,
     Object password)

    Assigns the destination URL, method and other optional attributes of a pending request.

    Parameters:

    method - the method to use to send the request to the server (GET, POST, etc)

    urlParam - the URL to send the request to

    asyncParam - Whether or not to send the request to the server asynchronously, defaults to true

    user - If authentication is needed for the specified URL, the username to use to authenticate

    password - If authentication is needed for the specified URL, the password to use to authenticate

  • send

    public void send(Object content)

    Sends the specified content to the server in an HTTP request and receives the response.

    Parameters:

    content - the body of the message being sent with the request

  • setRequestHeader

    public void setRequestHeader(String name,
     String value)

    Sets the specified header to the specified value. The open method must be called before this method, or an error will occur.

    Parameters:

    name - the name of the header being set

    value - the value of the header being set

  • overrideMimeType

    public void overrideMimeType(String mimeType)

    Override the mime type returned by the server (if any). This may be used, for example, to force a stream to be treated and parsed as text/xml, even if the server does not report it as such. This must be done before the send method is invoked.

    Parameters:

    mimeType - the type used to override that returned by the server (if any)

    See Also:

    XUL Planet

  • isWithCredentials

    public boolean isWithCredentials()

    Returns the withCredentials property.

    Returns:

    the withCredentials property

  • setWithCredentials

    public void setWithCredentials(boolean withCredentials)

    Sets the withCredentials property.

    Parameters:

    withCredentials - the withCredentials property.

  • getUpload

    public XMLHttpRequestUpload getUpload()

    Returns the upload property.

    Returns:

    the upload property

  • getOnreadystatechange

    public org.htmlunit.corejs.javascript.Function getOnreadystatechange()

    Returns the event handler that fires on ready state change.

    Overrides:

    getOnreadystatechange in class XMLHttpRequestEventTarget

    Returns:

    the event handler that fires on ready state change

  • setOnreadystatechange

    public void setOnreadystatechange(org.htmlunit.corejs.javascript.Function readyStateChangeHandler)

    Sets the event handler that fires on ready state change.

    Overrides:

    setOnreadystatechange in class XMLHttpRequestEventTarget

    Parameters:

    readyStateChangeHandler - the event handler that fires on ready state change

  • getTimeout

    public int getTimeout()

    Returns:

    the number of milliseconds a request can take before automatically being terminated. The default value is 0, which means there is no timeout.

  • setTimeout

    public void setTimeout(int timeout)

    Sets the number of milliseconds a request can take before automatically being terminated.

    Parameters:

    timeout - the timeout in milliseconds