mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-17 15:25:52 +00:00
5dec0e0beb
This patch was autogenerated by my decomponents.py
It covers almost every file with the extension js, jsm, html, py,
xhtml, or xul.
It removes blank lines after removed lines, when the removed lines are
preceded by either blank lines or the start of a new block. The "start
of a new block" is defined fairly hackily: either the line starts with
//, ends with */, ends with {, <![CDATA[, """ or '''. The first two
cover comments, the third one covers JS, the fourth covers JS embedded
in XUL, and the final two cover JS embedded in Python. This also
applies if the removed line was the first line of the file.
It covers the pattern matching cases like "var {classes: Cc,
interfaces: Ci, utils: Cu, results: Cr} = Components;". It'll remove
the entire thing if they are all either Ci, Cr, Cc or Cu, or it will
remove the appropriate ones and leave the residue behind. If there's
only one behind, then it will turn it into a normal, non-pattern
matching variable definition. (For instance, "const { classes: Cc,
Constructor: CC, interfaces: Ci, utils: Cu } = Components" becomes
"const CC = Components.Constructor".)
MozReview-Commit-ID: DeSHcClQ7cG
--HG--
extra : rebase_source : d9c41878036c1ef7766ef5e91a7005025bc1d72b
96 lines
4.0 KiB
JavaScript
96 lines
4.0 KiB
JavaScript
/* -*- indent-tabs-mode: nil; js-indent-level: 2 -*- */
|
|
/* vim: set ts=2 et sw=2 tw=80 filetype=javascript: */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
"use strict";
|
|
|
|
var EXPORTED_SYMBOLS = [
|
|
"Promise"
|
|
];
|
|
|
|
/**
|
|
* This module implements the "promise" construct, according to the
|
|
* "Promises/A+" proposal as known in April 2013, documented here:
|
|
*
|
|
* <http://promises-aplus.github.com/promises-spec/>
|
|
*
|
|
* A promise is an object representing a value that may not be available yet.
|
|
* Internally, a promise can be in one of three states:
|
|
*
|
|
* - Pending, when the final value is not available yet. This is the only state
|
|
* that may transition to one of the other two states.
|
|
*
|
|
* - Resolved, when and if the final value becomes available. A resolution
|
|
* value becomes permanently associated with the promise. This may be any
|
|
* value, including "undefined".
|
|
*
|
|
* - Rejected, if an error prevented the final value from being determined. A
|
|
* rejection reason becomes permanently associated with the promise. This may
|
|
* be any value, including "undefined", though it is generally an Error
|
|
* object, like in exception handling.
|
|
*
|
|
* A reference to an existing promise may be received by different means, for
|
|
* example as the return value of a call into an asynchronous API. In this
|
|
* case, the state of the promise can be observed but not directly controlled.
|
|
*
|
|
* To observe the state of a promise, its "then" method must be used. This
|
|
* method registers callback functions that are called as soon as the promise is
|
|
* either resolved or rejected. The method returns a new promise, that in turn
|
|
* is resolved or rejected depending on the state of the original promise and on
|
|
* the behavior of the callbacks. For example, unhandled exceptions in the
|
|
* callbacks cause the new promise to be rejected, even if the original promise
|
|
* is resolved. See the documentation of the "then" method for details.
|
|
*
|
|
* Promises may also be created using the "Promise.defer" function, the main
|
|
* entry point of this module. The function, along with the new promise,
|
|
* returns separate methods to change its state to be resolved or rejected.
|
|
* See the documentation of the "Deferred" prototype for details.
|
|
*
|
|
* -----------------------------------------------------------------------------
|
|
*
|
|
* Cu.import("resource://gre/modules/Promise.jsm");
|
|
*
|
|
* // This function creates and returns a new promise.
|
|
* function promiseValueAfterTimeout(aValue, aTimeout)
|
|
* {
|
|
* let deferred = Promise.defer();
|
|
*
|
|
* try {
|
|
* // An asynchronous operation will trigger the resolution of the promise.
|
|
* // In this example, we don't have a callback that triggers a rejection.
|
|
* do_timeout(aTimeout, function () {
|
|
* deferred.resolve(aValue);
|
|
* });
|
|
* } catch (ex) {
|
|
* // Generally, functions returning promises propagate exceptions through
|
|
* // the returned promise, though they may also choose to fail early.
|
|
* deferred.reject(ex);
|
|
* }
|
|
*
|
|
* // We don't return the deferred to the caller, but only the contained
|
|
* // promise, so that the caller cannot accidentally change its state.
|
|
* return deferred.promise;
|
|
* }
|
|
*
|
|
* // This code uses the promise returned be the function above.
|
|
* let promise = promiseValueAfterTimeout("Value", 1000);
|
|
*
|
|
* let newPromise = promise.then(function onResolve(aValue) {
|
|
* do_print("Resolved with this value: " + aValue);
|
|
* }, function onReject(aReason) {
|
|
* do_print("Rejected with this reason: " + aReason);
|
|
* });
|
|
*
|
|
* // Unexpected errors should always be reported at the end of a promise chain.
|
|
* newPromise.then(null, Components.utils.reportError);
|
|
*
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
|
|
// eslint-disable-next-line mozilla/use-services
|
|
Cc["@mozilla.org/moz/jssubscript-loader;1"]
|
|
.getService(Ci.mozIJSSubScriptLoader)
|
|
.loadSubScript("resource://gre/modules/Promise-backend.js", this);
|