A DOMRequest object represents an ongoing operation. It provides callbacks that are called when the operation completes, as well as a reference to the operation's result. A DOM method that initiates an ongoing operation may return a DOMRequest object that you can use to monitor the progress of that operation.

Note: This feature is available in Web Workers.

Properties

DOMRequest.onsuccess
A callback handler called when the operation represented by the DOMRequest is completed.
DOMRequest.onerror
A callback handler that gets called when an error occurs while processing the operation.
DOMRequest.readyState
A string indicating whether or not the operation is finished running. Its value is either "done" or "pending".
DOMRequest.result
The operation's result.
DOMRequest.error
Error information, if any.

Methods

None.

Example

An example of using the onsuccessonerror, result, and error properties of a DOMRequest object.

var pending = navigator.mozApps.install(manifestUrl);

pending.onsuccess = function () {
  // Save the App object that is returned
  var appRecord = this.result;
  alert('Installation successful!');
};
pending.onerror = function () {
  // Display the name of the error
  alert('Install failed, error: ' + this.error.name);
};

Specifications

Not currently part of any specification.

Browser compatibility

Supported in Firefox 13.
Available in workers in Firefox 41.

See also

Document Tags and Contributors

Last updated by: wbamberg,