ember-source 4.6.0-alpha.2 → 4.6.0-alpha.3

package/dist/ember-testing.js

@@ -6,7 +6,7 @@
  *            Portions Copyright 2008-2011 Apple Inc. All rights reserved.
  * @license   Licensed under MIT license
  *            See https://raw.github.com/emberjs/ember.js/master/LICENSE
- * @version   4.6.0-alpha.2
+ * @version   4.6.0-alpha.3
  */
 /* eslint-disable no-var */
 
@@ -868,30 +868,19 @@ define("ember-testing/lib/adapters/adapter", ["exports", "@ember/-internals/runt
   });
   _exports.default = void 0;
 
-  /**
-   @module @ember/test
-  */
-
-  /**
-    The primary purpose of this class is to create hooks that can be implemented
-    by an adapter for various test frameworks.
-  
-    @class TestAdapter
-    @public
-  */
-  var _default = _runtime.Object.extend({
+  var Adapter = _runtime.Object.extend({
     /**
       This callback will be called whenever an async operation is about to start.
-       Override this to call your framework's methods that handle async
+         Override this to call your framework's methods that handle async
       operations.
-       @public
+         @public
       @method asyncStart
     */
     asyncStart() {},
 
     /**
       This callback will be called whenever an async operation has completed.
-       @public
+         @public
       @method asyncEnd
     */
     asyncEnd() {},
@@ -900,13 +889,13 @@ define("ember-testing/lib/adapters/adapter", ["exports", "@ember/-internals/runt
       Override this method with your testing framework's false assertion.
       This function is called whenever an exception occurs causing the testing
       promise to fail.
-       QUnit example:
-       ```javascript
+         QUnit example:
+         ```javascript
         exception: function(error) {
           ok(false, error);
         };
       ```
-       @public
+         @public
       @method exception
       @param {String} error The exception to be raised.
     */
@@ -916,6 +905,7 @@ define("ember-testing/lib/adapters/adapter", ["exports", "@ember/-internals/runt
 
   });
 
+  var _default = Adapter;
   _exports.default = _default;
 });
 define("ember-testing/lib/adapters/qunit", ["exports", "@ember/-internals/utils", "ember-testing/lib/adapters/adapter"], function (_exports, _utils, _adapter) {
@@ -927,27 +917,17 @@ define("ember-testing/lib/adapters/qunit", ["exports", "@ember/-internals/utils"
   _exports.default = void 0;
 
   /* globals QUnit */
+  function isVeryOldQunit(obj) {
+    return obj != null && typeof obj.stop === 'function';
+  }
 
-  /**
-     @module ember
-  */
-
-  /**
-    This class implements the methods defined by TestAdapter for the
-    QUnit testing framework.
-  
-    @class QUnitAdapter
-    @namespace Ember.Test
-    @extends TestAdapter
-    @public
-  */
-  var _default = _adapter.default.extend({
+  var QUnitAdapter = _adapter.default.extend({
     init() {
       this.doneCallbacks = [];
     },
 
     asyncStart() {
-      if (typeof QUnit.stop === 'function') {
+      if (isVeryOldQunit(QUnit)) {
         // very old QUnit version
         // eslint-disable-next-line qunit/no-qunit-stop
         QUnit.stop();
@@ -960,7 +940,7 @@ define("ember-testing/lib/adapters/qunit", ["exports", "@ember/-internals/utils"
       // checking for QUnit.stop here (even though we _need_ QUnit.start) because
       // QUnit.start() still exists in QUnit 2.x (it just throws an error when calling
       // inside a test context)
-      if (typeof QUnit.stop === 'function') {
+      if (isVeryOldQunit(QUnit)) {
         QUnit.start();
       } else {
         var done = this.doneCallbacks.pop(); // This can be null if asyncStart() was called outside of a test
@@ -977,9 +957,10 @@ define("ember-testing/lib/adapters/qunit", ["exports", "@ember/-internals/utils"
 
   });
 
+  var _default = QUnitAdapter;
   _exports.default = _default;
 });
-define("ember-testing/lib/ext/application", ["@ember/application", "ember-testing/lib/setup_for_testing", "ember-testing/lib/test/helpers", "ember-testing/lib/test/promise", "ember-testing/lib/test/run", "ember-testing/lib/test/on_inject_helpers", "ember-testing/lib/test/adapter"], function (_application, _setup_for_testing, _helpers, _promise, _run, _on_inject_helpers, _adapter) {
+define("ember-testing/lib/ext/application", ["@ember/application", "ember-testing/lib/setup_for_testing", "ember-testing/lib/test/helpers", "ember-testing/lib/test/promise", "ember-testing/lib/test/run", "ember-testing/lib/test/on_inject_helpers", "ember-testing/lib/test/adapter", "@ember/debug"], function (_application, _setup_for_testing, _helpers, _promise, _run, _on_inject_helpers, _adapter, _debug) {
   "use strict";
 
   _application.default.reopen({
@@ -988,7 +969,7 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
      are created once you call `injectTestHelpers` on your `Application`
      instance. The included helpers are also available on the `window` object by
      default, but can be used from this object on the individual application also.
-       @property testHelpers
+         @property testHelpers
       @type {Object}
       @default {}
       @public
@@ -998,9 +979,9 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
     /**
      This property will contain the original methods that were registered
      on the `helperContainer` before `injectTestHelpers` is called.
-      When `removeTestHelpers` is called, these methods are restored to the
+        When `removeTestHelpers` is called, these methods are restored to the
      `helperContainer`.
-       @property originalMethods
+         @property originalMethods
       @type {Object}
       @default {}
       @private
@@ -1012,7 +993,7 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
     This property indicates whether or not this application is currently in
     testing mode. This is set when `setupForTesting` is called on the current
     application.
-     @property testing
+       @property testing
     @type {Boolean}
     @default false
     @since 1.3.0
@@ -1027,11 +1008,11 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
       (preventing both accidental leaking of state between tests and interference
       with your testing framework). `setupForTesting` should only be called after
       setting a custom `router` class (for example `App.Router = Router.extend(`).
-       Example:
-       ```
+         Example:
+         ```
       App.setupForTesting();
       ```
-       @method setupForTesting
+         @method setupForTesting
       @public
     */
     setupForTesting() {
@@ -1045,7 +1026,7 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
     /**
       This will be used as the container to inject the test helpers into. By
       default the helpers are injected into `window`.
-       @property helperContainer
+         @property helperContainer
       @type {Object} The object to be used for test helpers.
       @default window
       @since 1.2.0
@@ -1059,13 +1040,13 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
       to `window`. If a function of the same name has already been defined it will be cached
       (so that it can be reset if the helper is removed with `unregisterHelper` or
       `removeTestHelpers`).
-       Any callbacks registered with `onInjectHelpers` will be called once the
+         Any callbacks registered with `onInjectHelpers` will be called once the
       helpers have been injected.
-       Example:
+         Example:
       ```
       App.injectTestHelpers();
       ```
-       @method injectTestHelpers
+         @method injectTestHelpers
       @public
     */
     injectTestHelpers(helperContainer) {
@@ -1086,8 +1067,11 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
       this.testHelpers = {};
 
       for (var name in _helpers.helpers) {
-        this.originalMethods[name] = this.helperContainer[name];
-        this.testHelpers[name] = this.helperContainer[name] = helper(this, name);
+        // SAFETY: It is safe to access a property on an object
+        this.originalMethods[name] = this.helperContainer[name]; // SAFETY: It is not quite as safe to do this, but it _seems_ to be ok.
+
+        this.testHelpers[name] = this.helperContainer[name] = helper(this, name); // SAFETY: We checked that it exists
+
         protoWrap(_promise.default.prototype, name, helper(this, name), _helpers.helpers[name].meta.wait);
       }
 
@@ -1097,11 +1081,11 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
     /**
       This removes all helpers that have been registered, and resets and functions
       that were overridden by the helpers.
-       Example:
-       ```javascript
+         Example:
+         ```javascript
       App.removeTestHelpers();
       ```
-       @public
+         @public
       @method removeTestHelpers
     */
     removeTestHelpers() {
@@ -1110,7 +1094,8 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
       }
 
       for (var name in _helpers.helpers) {
-        this.helperContainer[name] = this.originalMethods[name];
+        this.helperContainer[name] = this.originalMethods[name]; // SAFETY: This is a weird thing, but it's not technically unsafe here.
+
         delete _promise.default.prototype[name];
         delete this.testHelpers[name];
         delete this.originalMethods[name];
@@ -1123,6 +1108,7 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
 
 
   function protoWrap(proto, name, callback, isAsync) {
+    // SAFETY: This isn't entirely safe, but it _seems_ to be ok.
     proto[name] = function () {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
         args[_key] = arguments[_key];
@@ -1131,6 +1117,7 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
       if (isAsync) {
         return callback.apply(this, args);
       } else {
+        // SAFETY: This is not actually safe.
         return this.then(function () {
           return callback.apply(this, args);
         });
@@ -1139,8 +1126,10 @@ define("ember-testing/lib/ext/application", ["@ember/application", "ember-testin
   }
 
   function helper(app, name) {
-    var fn = _helpers.helpers[name].method;
-    var meta = _helpers.helpers[name].meta;
+    var helper = _helpers.helpers[name];
+    (true && !(helper) && (0, _debug.assert)(`[BUG] Missing helper: ${name}`, helper));
+    var fn = helper.method;
+    var meta = helper.meta;
 
     if (!meta.wait) {
       return function () {
@@ -1204,7 +1193,7 @@ define("ember-testing/lib/helpers", ["ember-testing/lib/test/helpers", "ember-te
   (0, _helpers.registerHelper)('currentURL', _current_url.default);
   (0, _helpers.registerHelper)('resumeTest', _pause_test.resumeTest);
 });
-define("ember-testing/lib/helpers/and_then", ["exports"], function (_exports) {
+define("ember-testing/lib/helpers/and_then", ["exports", "@ember/debug"], function (_exports, _debug) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1213,10 +1202,12 @@ define("ember-testing/lib/helpers/and_then", ["exports"], function (_exports) {
   _exports.default = andThen;
 
   function andThen(app, callback) {
-    return app.testHelpers.wait(callback(app));
+    var wait = app.testHelpers['wait'];
+    (true && !(wait) && (0, _debug.assert)('[BUG] Missing wait helper', wait));
+    return wait(callback(app));
   }
 });
-define("ember-testing/lib/helpers/current_path", ["exports", "@ember/-internals/metal"], function (_exports, _metal) {
+define("ember-testing/lib/helpers/current_path", ["exports", "@ember/-internals/metal", "@ember/-internals/routing", "@ember/debug"], function (_exports, _metal, _routing, _debug) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1247,12 +1238,15 @@ define("ember-testing/lib/helpers/current_path", ["exports", "@ember/-internals/
   @public
   */
   function currentPath(app) {
+    (true && !(app.__container__) && (0, _debug.assert)('[BUG] app.__container__ is not set', app.__container__));
+
     var routingService = app.__container__.lookup('service:-routing');
 
+    (true && !(routingService instanceof _routing.RoutingService) && (0, _debug.assert)('[BUG] service:-routing is not a RoutingService', routingService instanceof _routing.RoutingService));
     return (0, _metal.get)(routingService, 'currentPath');
   }
 });
-define("ember-testing/lib/helpers/current_route_name", ["exports", "@ember/-internals/metal"], function (_exports, _metal) {
+define("ember-testing/lib/helpers/current_route_name", ["exports", "@ember/-internals/metal", "@ember/-internals/routing", "@ember/debug"], function (_exports, _metal, _routing, _debug) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1282,12 +1276,15 @@ define("ember-testing/lib/helpers/current_route_name", ["exports", "@ember/-inte
   @public
   */
   function currentRouteName(app) {
+    (true && !(app.__container__) && (0, _debug.assert)('[BUG] app.__container__ is not set', app.__container__));
+
     var routingService = app.__container__.lookup('service:-routing');
 
+    (true && !(routingService instanceof _routing.RoutingService) && (0, _debug.assert)('[BUG] service:-routing is not a RoutingService', routingService instanceof _routing.RoutingService));
     return (0, _metal.get)(routingService, 'currentRouteName');
   }
 });
-define("ember-testing/lib/helpers/current_url", ["exports", "@ember/-internals/metal"], function (_exports, _metal) {
+define("ember-testing/lib/helpers/current_url", ["exports", "@ember/-internals/metal", "@ember/debug", "@ember/routing/router"], function (_exports, _metal, _debug, _router) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1318,9 +1315,14 @@ define("ember-testing/lib/helpers/current_url", ["exports", "@ember/-internals/m
   @public
   */
   function currentURL(app) {
+    (true && !(app.__container__) && (0, _debug.assert)('[BUG] app.__container__ is not set', app.__container__));
+
     var router = app.__container__.lookup('router:main');
 
-    return (0, _metal.get)(router, 'location').getURL();
+    (true && !(router instanceof _router.default) && (0, _debug.assert)('[BUG] router:main is not a Router', router instanceof _router.default));
+    var location = (0, _metal.get)(router, 'location');
+    (true && !(typeof location !== 'string') && (0, _debug.assert)('[BUG] location is still a string', typeof location !== 'string'));
+    return location.getURL();
   }
 });
 define("ember-testing/lib/helpers/pause_test", ["exports", "@ember/-internals/runtime", "@ember/debug"], function (_exports, _runtime, _debug) {
@@ -1395,7 +1397,7 @@ define("ember-testing/lib/helpers/pause_test", ["exports", "@ember/-internals/ru
     }, 'TestAdapter paused promise');
   }
 });
-define("ember-testing/lib/helpers/visit", ["exports", "@ember/runloop"], function (_exports, _runloop) {
+define("ember-testing/lib/helpers/visit", ["exports", "@ember/debug", "@ember/routing/router", "@ember/runloop"], function (_exports, _debug, _router, _runloop) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1422,18 +1424,24 @@ define("ember-testing/lib/helpers/visit", ["exports", "@ember/runloop"], functio
     @public
   */
   function visit(app, url) {
+    (true && !(app.__container__) && (0, _debug.assert)('[BUG] Missing container', app.__container__));
+
     var router = app.__container__.lookup('router:main');
 
+    (true && !(router instanceof _router.default) && (0, _debug.assert)('[BUG] router:main is not a Router', router instanceof _router.default));
     var shouldHandleURL = false;
     app.boot().then(() => {
+      (true && !(typeof router.location !== 'string') && (0, _debug.assert)('[BUG] router.location is still a string', typeof router.location !== 'string'));
       router.location.setURL(url);
 
       if (shouldHandleURL) {
+        (true && !(app.__deprecatedInstance__) && (0, _debug.assert)("[BUG] __deprecatedInstance__ isn't set", app.__deprecatedInstance__));
         (0, _runloop.run)(app.__deprecatedInstance__, 'handleURL', url);
       }
     });
 
     if (app._readinessDeferrals > 0) {
+      // SAFETY: This should be safe, though it is odd.
       router.initialURL = url;
       (0, _runloop.run)(app, 'advanceReadiness');
       delete router.initialURL;
@@ -1441,10 +1449,12 @@ define("ember-testing/lib/helpers/visit", ["exports", "@ember/runloop"], functio
       shouldHandleURL = true;
     }
 
-    return app.testHelpers.wait();
+    var wait = app.testHelpers['wait'];
+    (true && !(wait) && (0, _debug.assert)('[BUG] missing wait helper', wait));
+    return wait();
   }
 });
-define("ember-testing/lib/helpers/wait", ["exports", "ember-testing/lib/test/waiters", "@ember/-internals/runtime", "@ember/runloop", "ember-testing/lib/test/pending_requests"], function (_exports, _waiters, _runtime, _runloop, _pending_requests) {
+define("ember-testing/lib/helpers/wait", ["exports", "ember-testing/lib/test/waiters", "@ember/-internals/runtime", "@ember/runloop", "ember-testing/lib/test/pending_requests", "@ember/debug", "@ember/routing/router"], function (_exports, _waiters, _runtime, _runloop, _pending_requests, _debug, _router) {
   "use strict";
 
   Object.defineProperty(_exports, "__esModule", {
@@ -1488,8 +1498,11 @@ define("ember-testing/lib/helpers/wait", ["exports", "ember-testing/lib/test/wai
   */
   function wait(app, value) {
     return new _runtime.RSVP.Promise(function (resolve) {
-      var router = app.__container__.lookup('router:main'); // Every 10ms, poll for the async thing to have finished
+      (true && !(app.__container__) && (0, _debug.assert)('[BUG] Missing container', app.__container__));
+
+      var router = app.__container__.lookup('router:main');
 
+      (true && !(router instanceof _router.default) && (0, _debug.assert)('[BUG] Expected router:main to be a subclass of Ember Router', router instanceof _router.default)); // Every 10ms, poll for the async thing to have finished
 
       var watcher = setInterval(() => {
         // 1. If the router is loading, keep polling
@@ -1525,9 +1538,9 @@ define("ember-testing/lib/initializers", ["@ember/application"], function (_appl
   "use strict";
 
   var name = 'deferReadiness in `testing` mode';
-  (0, _application.onLoad)('Ember.Application', function (Application) {
-    if (!Application.initializers[name]) {
-      Application.initializer({
+  (0, _application.onLoad)('Ember.Application', function (ApplicationClass) {
+    if (!ApplicationClass.initializers[name]) {
+      ApplicationClass.initializer({
         name: name,
 
         initialize(application) {
@@ -1598,7 +1611,7 @@ define("ember-testing/lib/test", ["exports", "ember-testing/lib/test/helpers", "
   var Test = {
     /**
       Hash containing all known test helpers.
-       @property _helpers
+         @property _helpers
       @private
       @since 1.7.0
     */
@@ -1681,7 +1694,8 @@ define("ember-testing/lib/test/adapter", ["exports", "@ember/-internals/error-ha
   }
 
   function adapterDispatch(error) {
-    adapter.exception(error);
+    adapter.exception(error); // @ts-expect-error Normally unreachable
+
     console.error(error.stack); // eslint-disable-line no-console
   }
 });
@@ -1824,7 +1838,9 @@ define("ember-testing/lib/test/helpers", ["exports", "ember-testing/lib/test/pro
 
 
   function unregisterHelper(name) {
-    delete helpers[name];
+    delete helpers[name]; // SAFETY: This isn't necessarily a safe thing to do, but in terms of the immediate types here
+    // it won't error.
+
     delete _promise.default.prototype[name];
   }
 });
@@ -1873,8 +1889,8 @@ define("ember-testing/lib/test/on_inject_helpers", ["exports"], function (_expor
   }
 
   function invokeInjectHelpersCallbacks(app) {
-    for (var i = 0; i < callbacks.length; i++) {
-      callbacks[i](app);
+    for (var callback of callbacks) {
+      callback(app);
     }
   }
 });
@@ -1923,22 +1939,17 @@ define("ember-testing/lib/test/promise", ["exports", "@ember/-internals/runtime"
   _exports.getLastPromise = getLastPromise;
   _exports.promise = promise;
   _exports.resolve = resolve;
-  var lastPromise;
+  var lastPromise = null;
 
   class TestPromise extends _runtime.RSVP.Promise {
-    constructor() {
-      super(...arguments);
+    constructor(executor, label) {
+      super(executor, label);
       lastPromise = this;
     }
 
-    then(_onFulfillment) {
-      var onFulfillment = typeof _onFulfillment === 'function' ? result => isolate(_onFulfillment, result) : undefined;
-
-      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-        args[_key - 1] = arguments[_key];
-      }
-
-      return super.then(onFulfillment, ...args);
+    then(onFulfilled, onRejected, label) {
+      var normalizedOnFulfilled = typeof onFulfilled === 'function' ? result => isolate(onFulfilled, result) : undefined;
+      return super.then(normalizedOnFulfilled, onRejected, label);
     }
 
   }
@@ -1990,10 +2001,10 @@ define("ember-testing/lib/test/promise", ["exports", "@ember/-internals/runtime"
   // 3. Return the last promise created during method
 
 
-  function isolate(onFulfillment, result) {
+  function isolate(onFulfilled, result) {
     // Reset lastPromise for nested helpers
     lastPromise = null;
-    var value = onFulfillment(result);
+    var value = onFulfilled(result);
     var promise = lastPromise;
     lastPromise = null; // If the method returned a promise
     // return that promise. If not,
@@ -2037,55 +2048,25 @@ define("ember-testing/lib/test/waiters", ["exports"], function (_exports) {
   */
   var contexts = [];
   var callbacks = [];
-  /**
-     This allows ember-testing to play nicely with other asynchronous
-     events, such as an application that is waiting for a CSS3
-     transition or an IndexDB transaction. The waiter runs periodically
-     after each async helper (i.e. `click`, `andThen`, `visit`, etc) has executed,
-     until the returning result is truthy. After the waiters finish, the next async helper
-     is executed and the process repeats.
-  
-     For example:
-  
-     ```javascript
-     import { registerWaiter } from '@ember/test';
-  
-     registerWaiter(function() {
-       return myPendingTransactions() === 0;
-     });
-     ```
-     The `context` argument allows you to optionally specify the `this`
-     with which your callback will be invoked.
-  
-     For example:
-  
-     ```javascript
-     import { registerWaiter } from '@ember/test';
-  
-     registerWaiter(MyDB, MyDB.hasPendingTransactions);
-     ```
-  
-     @public
-     @for @ember/test
-     @static
-     @method registerWaiter
-     @param {Object} context (optional)
-     @param {Function} callback
-     @since 1.2.0
-  */
 
-  function registerWaiter(context, callback) {
+  function registerWaiter() {
+    var checkedCallback;
+    var checkedContext;
+
     if (arguments.length === 1) {
-      callback = context;
-      context = null;
+      checkedContext = null;
+      checkedCallback = arguments.length <= 0 ? undefined : arguments[0];
+    } else {
+      checkedContext = arguments.length <= 0 ? undefined : arguments[0];
+      checkedCallback = arguments.length <= 1 ? undefined : arguments[1];
     }
 
-    if (indexOf(context, callback) > -1) {
+    if (indexOf(checkedContext, checkedCallback) > -1) {
       return;
     }
 
-    contexts.push(context);
-    callbacks.push(callback);
+    contexts.push(checkedContext);
+    callbacks.push(checkedCallback);
   }
   /**
      `unregisterWaiter` is used to unregister a callback that was
@@ -2142,7 +2123,7 @@ define("ember-testing/lib/test/waiters", ["exports"], function (_exports) {
 
     for (var i = 0; i < callbacks.length; i++) {
       var context = contexts[i];
-      var callback = callbacks[i];
+      var callback = callbacks[i]; // SAFETY: The loop ensures that this exists
 
       if (!callback.call(context)) {
         return true;