A reference to the XMLHttpRequest object used to make an operation request on a resource of a Data Object Service.

In the case of an asynchronous call, this property may not be available until after the XMLHttpRequest object is created.

Note: You can use the XMLHttpRequest object referenced by this property to return error information that originates from the web server that hosts the Data Object Service handling the operation request. As of Progress Data Objects 4.3 and later, the JSDO provides a getErrors( ) method that returns all error information for an operation request, including error information that originates from the hosting web server. For more information, see the getErrors( ) method description.

Data type: Object

Access: Read-only

Applies to: request object

The xhr property is available for the following events or in the request object returned to a jQuery Promise callback:

  • afterFill
  • afterInvoke

The xhr property is available for the following events after calling the JSDO saveChanges( ) method either with an empty parameter list or with the single parameter value of false:

  • afterCreate
  • afterDelete
  • afterUpdate

The xhr property is available only for the following event or in the request object returned to a jQuery Promise callback after calling saveChanges(true) on a JSDO resource that supports a Data Object Submit operation:

  • afterSaveChanges

This request object property is also available for any session online and offline events that are fired in response to the associated resource operation when it encounters a change in the online status of the JSDO login session (JSDOSession or Session object). The request object is itself passed as a parameter to any event handler functions that you subscribe or register to JSDO events, any returned jQuery Promises, and to the online and offline events of the session that manages Data Object Services for the JSDO. This object is also returned as the value of any JSDO invocation method that you execute synchronously.

See also:

fill( ) method, getErrors( ) method, invocation method, invoke( ) method, response property, saveChanges( ) method