MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Your Search Results

    DOMRequest

    Non-standard
    This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

    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.

    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);
    };

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support ? 13.0 (13.0) ? ? ?
    Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support ? ? 13.0 (13.0) ? ? ?

    Specification

    Not currently part of any specification.

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy, jsx, Jeremie, ethertank, kscarfone, teoli, markg
    Last updated by: teoli,