ember-source 2.16.0 → 2.16.1

data/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   2.16.0
+ * @version   2.16.1
  */
 
 var enifed, requireModule, Ember;
@@ -190,12 +190,10 @@ enifed('ember-debug/deprecate', ['exports', 'ember-debug/error', 'ember-console'
 
   exports.missingOptionsUntilDeprecation = exports.missingOptionsIdDeprecation = exports.missingOptionsDeprecation = exports.registerHandler = undefined;
 
-
   /**
-  @module ember
-  @submodule ember-debug
+   @module @ember/debug
+   @public
   */
-
   /**
     Allows for runtime registration of handler functions that override the default deprecation behavior.
     Deprecations are invoked by calls to [Ember.deprecate](https://emberjs.com/api/classes/Ember.html#method_deprecate).
@@ -228,7 +226,7 @@ enifed('ember-debug/deprecate', ['exports', 'ember-debug/error', 'ember-console'
     @public
     @static
     @method registerDeprecationHandler
-    @for Ember.Debug
+    @for @ember/debug
     @param handler {Function} A function to handle deprecation calls.
     @since 2.1.0
   */
@@ -320,13 +318,17 @@ enifed('ember-debug/deprecate', ['exports', 'ember-debug/error', 'ember-console'
     exports.missingOptionsDeprecation = missingOptionsDeprecation = 'When calling `Ember.deprecate` you ' + 'must provide an `options` hash as the third parameter.  ' + '`options` should include `id` and `until` properties.';
     exports.missingOptionsIdDeprecation = missingOptionsIdDeprecation = 'When calling `Ember.deprecate` you must provide `id` in options.';
     exports.missingOptionsUntilDeprecation = missingOptionsUntilDeprecation = 'When calling `Ember.deprecate` you must provide `until` in options.';
-
+    /**
+     @module @ember/application
+     @public
+     */
     /**
       Display a deprecation warning with the provided message and a stack trace
       (Chrome and Firefox only).
        * In a production build, this method is defined as an empty function (NOP).
       Uses of this method in Ember itself are stripped from the ember.prod.js build.
        @method deprecate
+      @for @ember/application/deprecations
       @param {String} message A description of the deprecation.
       @param {Boolean} test A boolean. If falsy, the deprecation will be displayed.
       @param {Object} options
@@ -338,7 +340,7 @@ enifed('ember-debug/deprecate', ['exports', 'ember-debug/error', 'ember-console'
         warning will be removed.
       @param {String} [options.url] An optional url to the transition guide on the
         emberjs.com website.
-      @for Ember
+      @static
       @public
       @since 1.0.0
     */
@@ -380,6 +382,9 @@ enifed('ember-debug/deprecate', ['exports', 'ember-debug/error', 'ember-console'
 enifed("ember-debug/error", ["exports", "ember-babel"], function (exports, _emberBabel) {
   "use strict";
 
+  /**
+   @module @ember/error
+  */
   function ExtendBuiltin(klass) {
     function ExtendableBuiltin() {
       klass.apply(this, arguments);
@@ -393,8 +398,7 @@ enifed("ember-debug/error", ["exports", "ember-babel"], function (exports, _embe
   /**
     A subclass of the JavaScript Error object for use in Ember.
   
-    @class Error
-    @namespace Ember
+    @class EmberError
     @extends Error
     @constructor
     @public
@@ -438,6 +442,10 @@ enifed('ember-debug/features', ['exports', 'ember-environment', 'ember/features'
   var FEATURES = _features.FEATURES;
 
 
+  /**
+   @module ember
+  */
+
   /**
     The hash of enabled Canary features. Add to this, any canary features
     before creating your application.
@@ -626,13 +634,7 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
   }
 
   /**
-  @module ember
-  @submodule ember-debug
-  */
-
-  /**
-  @class Ember
-  @public
+  @module @ember/debug
   */
 
   if (true) {
@@ -641,12 +643,15 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
        * In a production build, this method is defined as an empty function (NOP).
       Uses of this method in Ember itself are stripped from the ember.prod.js build.
        ```javascript
-      // Test for truthiness
-      Ember.assert('Must pass a valid object', obj);
+      import { assert } from '@ember/debug';
+       // Test for truthiness
+      assert('Must pass a valid object', obj);
        // Fail unconditionally
-      Ember.assert('This code path should never be run');
+      assert('This code path should never be run');
       ```
        @method assert
+      @static
+      @for @ember/debug
       @param {String} desc A description of the assertion. This will become
         the text of the Error thrown if the assertion fails.
       @param {Boolean} test Must be truthy for the assertion to pass. If
@@ -665,9 +670,12 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
        * In a production build, this method is defined as an empty function (NOP).
       Uses of this method in Ember itself are stripped from the ember.prod.js build.
        ```javascript
-      Ember.debug('I\'m a debug notice!');
+      import { debug } from '@ember/debug';
+       debug('I\'m a debug notice!');
       ```
        @method debug
+      @for @ember/debug
+      @static
       @param {String} message A debug message to display.
       @public
     */
@@ -686,6 +694,11 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
       _emberConsole.default.info.apply(undefined, arguments);
     });
 
+    /**
+     @module @ember/application
+     @public
+    */
+
     /**
       Alias an old, deprecated method with its new counterpart.
        Display a deprecation warning with the provided message and a stack trace
@@ -695,6 +708,8 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
       Ember.oldMethod = Ember.deprecateFunc('Please use the new, updated method', Ember.newMethod);
       ```
        @method deprecateFunc
+      @static
+      @for @ember/application/deprecations
       @param {String} message A description of the deprecation.
       @param {Object} [options] The options object for Ember.deprecate.
       @param {Function} func The new function called to replace its deprecated counterpart.
@@ -726,13 +741,19 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
       }
     });
 
+    /**
+     @module @ember/debug
+     @public
+    */
     /**
       Run a function meant for debugging.
        * In a production build, this method is defined as an empty function (NOP).
       Uses of this method in Ember itself are stripped from the ember.prod.js build.
        ```javascript
-      Ember.runInDebug(() => {
-        Ember.Component.reopen({
+      import Component from '@ember/component';
+      import { runInDebug } from '@ember/debug';
+       runInDebug(() => {
+        Component.reopen({
           didInsertElement() {
             console.log("I'm happy");
           }
@@ -740,6 +761,8 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
       });
       ```
        @method runInDebug
+      @for @ember/debug
+      @static
       @param {Function} func The function to be executed.
       @since 1.5.0
       @public
@@ -765,7 +788,7 @@ enifed('ember-debug/index', ['exports', 'ember-debug/warn', 'ember-debug/depreca
 
   if (true && !(0, _testing.isTesting)()) {
     /**
-       Will call `Ember.warn()` if ENABLE_OPTIONAL_FEATURES or
+       Will call `warn()` if ENABLE_OPTIONAL_FEATURES or
        any specific FEATURES flag is truthy.
         This method is called automatically in debug canary builds.
         @private
@@ -860,19 +883,19 @@ enifed('ember-debug/warn', ['exports', 'ember-console', 'ember-debug/deprecate',
       missingOptionsIdDeprecation = void 0;
 
   /**
-  @module ember
-  @submodule ember-debug
+  @module @ember/debug
   */
 
   if (true) {
     /**
       Allows for runtime registration of handler functions that override the default warning behavior.
-      Warnings are invoked by calls made to [Ember.warn](https://emberjs.com/api/classes/Ember.html#method_warn).
+      Warnings are invoked by calls made to [warn](https://emberjs.com/api/classes/Ember.html#method_warn).
       The following example demonstrates its usage by registering a handler that does nothing overriding Ember's
       default warning behavior.
        ```javascript
-      // next is not called, so no warnings get the default behavior
-      Ember.Debug.registerWarnHandler(() => {});
+      import { registerWarnHandler } from '@ember/debug';
+       // next is not called, so no warnings get the default behavior
+      registerWarnHandler(() => {});
       ```
        The handler function takes the following arguments:
        <ul>
@@ -886,7 +909,7 @@ enifed('ember-debug/warn', ['exports', 'ember-console', 'ember-debug/deprecate',
        @public
       @static
       @method registerWarnHandler
-      @for Ember.Debug
+      @for @ember/debug
       @param handler {Function} A function to handle warnings.
       @since 2.1.0
     */
@@ -901,14 +924,16 @@ enifed('ember-debug/warn', ['exports', 'ember-console', 'ember-debug/deprecate',
       }
     });
 
-    exports.missingOptionsDeprecation = missingOptionsDeprecation = 'When calling `Ember.warn` you ' + 'must provide an `options` hash as the third parameter.  ' + '`options` should include an `id` property.';
-    exports.missingOptionsIdDeprecation = missingOptionsIdDeprecation = 'When calling `Ember.warn` you must provide `id` in options.';
+    exports.missingOptionsDeprecation = missingOptionsDeprecation = 'When calling `warn` you ' + 'must provide an `options` hash as the third parameter.  ' + '`options` should include an `id` property.';
+    exports.missingOptionsIdDeprecation = missingOptionsIdDeprecation = 'When calling `warn` you must provide `id` in options.';
 
     /**
       Display a warning with the provided message.
        * In a production build, this method is defined as an empty function (NOP).
       Uses of this method in Ember itself are stripped from the ember.prod.js build.
        @method warn
+      @for @ember/debug
+      @static
       @param {String} message A warning to display.
       @param {Boolean} test An optional boolean. If falsy, the warning
         will be displayed.
@@ -916,7 +941,6 @@ enifed('ember-debug/warn', ['exports', 'ember-console', 'ember-debug/deprecate',
         `id` for this warning.  The `id` can be used by Ember debugging tools
         to change the behavior (raise, log, or silence) for that specific warning.
         The `id` should be namespaced by dots, e.g. "ember-debug.feature-flag-with-features-stripped"
-      @for Ember
       @public
       @since 1.0.0
     */
@@ -958,8 +982,7 @@ enifed('ember-testing/adapters/adapter', ['exports', 'ember-runtime'], function
   }
 
   /**
-   @module ember
-   @submodule ember-testing
+   @module @ember/test
   */
 
   /**
@@ -967,7 +990,6 @@ enifed('ember-testing/adapters/adapter', ['exports', 'ember-runtime'], function
     by an adapter for various test frameworks.
   
     @class Adapter
-    @namespace Ember.Test
     @public
   */
   exports.default = _emberRuntime.Object.extend({
@@ -1313,10 +1335,6 @@ enifed("ember-testing/helpers/and_then", ["exports"], function (exports) {
   "use strict";
 
   exports.default = andThen;
-  /**
-  @module ember
-  @submodule ember-testing
-  */
   function andThen(app, callback) {
     return app.testHelpers.wait(callback(app));
   }
@@ -1359,7 +1377,6 @@ enifed('ember-testing/helpers/click', ['exports', 'ember-testing/events'], funct
     return app.testHelpers.wait();
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/current_path', ['exports', 'ember-metal'], function (exports, _emberMetal) {
@@ -1391,7 +1408,6 @@ enifed('ember-testing/helpers/current_path', ['exports', 'ember-metal'], functio
     return (0, _emberMetal.get)(routingService, 'currentPath');
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/current_route_name', ['exports', 'ember-metal'], function (exports, _emberMetal) {
@@ -1421,7 +1437,6 @@ enifed('ember-testing/helpers/current_route_name', ['exports', 'ember-metal'], f
     return (0, _emberMetal.get)(routingService, 'currentRouteName');
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/current_url', ['exports', 'ember-metal'], function (exports, _emberMetal) {
@@ -1453,7 +1468,6 @@ enifed('ember-testing/helpers/current_url', ['exports', 'ember-metal'], function
     return (0, _emberMetal.get)(router, 'location').getURL();
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/fill_in', ['exports', 'ember-testing/events'], function (exports, _events) {
@@ -1500,7 +1514,6 @@ enifed('ember-testing/helpers/fill_in', ['exports', 'ember-testing/events'], fun
     return app.testHelpers.wait();
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/find', ['exports', 'ember-metal'], function (exports, _emberMetal) {
@@ -1539,7 +1552,6 @@ enifed('ember-testing/helpers/find', ['exports', 'ember-metal'], function (expor
     return $el;
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/find_with_assert', ['exports'], function (exports) {
@@ -1548,7 +1560,6 @@ enifed('ember-testing/helpers/find_with_assert', ['exports'], function (exports)
   exports.default = findWithAssert;
   /**
   @module ember
-  @submodule ember-testing
   */
   /**
     Like `find`, but throws an error if the element selector returns no results.
@@ -1588,7 +1599,6 @@ enifed("ember-testing/helpers/key_event", ["exports"], function (exports) {
   exports.default = keyEvent;
   /**
   @module ember
-  @submodule ember-testing
   */
   /**
     Simulates a key event, e.g. `keypress`, `keydown`, `keyup` with the desired keyCode
@@ -1640,7 +1650,6 @@ enifed('ember-testing/helpers/pause_test', ['exports', 'ember-runtime', 'ember-c
   */
   /**
   @module ember
-  @submodule ember-testing
   */
   function resumeTest() {
     (true && !(resume) && (0, _emberDebug.assert)('Testing has not been paused. There is nothing to resume.', resume));
@@ -1760,7 +1769,6 @@ enifed('ember-testing/helpers/trigger_event', ['exports', 'ember-testing/events'
     return app.testHelpers.wait();
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/visit', ['exports', 'ember-metal'], function (exports, _emberMetal) {
@@ -1810,7 +1818,6 @@ enifed('ember-testing/helpers/visit', ['exports', 'ember-metal'], function (expo
     return app.testHelpers.wait();
   } /**
     @module ember
-    @submodule ember-testing
     */
 });
 enifed('ember-testing/helpers/wait', ['exports', 'ember-testing/test/waiters', 'ember-runtime', 'ember-metal', 'ember-testing/test/pending_requests'], function (exports, _waiters, _emberRuntime, _emberMetal, _pending_requests) {
@@ -1849,7 +1856,6 @@ enifed('ember-testing/helpers/wait', ['exports', 'ember-testing/test/waiters', '
   */
   /**
   @module ember
-  @submodule ember-testing
   */
   function wait(app, value) {
     return new _emberRuntime.RSVP.Promise(function (resolve) {
@@ -1979,7 +1985,6 @@ enifed('ember-testing/support', ['ember-debug', 'ember-views', 'ember-environmen
 
   /**
     @module ember
-    @submodule ember-testing
   */
 
   var $ = _emberViews.jQuery;
@@ -2084,7 +2089,6 @@ enifed('ember-testing/test', ['exports', 'ember-testing/test/helpers', 'ember-te
   */
   /**
     @module ember
-    @submodule ember-testing
   */
   Object.defineProperty(Test, 'adapter', {
     get: _adapter.getAdapter,
@@ -2141,6 +2145,9 @@ enifed('ember-testing/test/helpers', ['exports', 'ember-testing/test/promise'],
   exports.registerAsyncHelper = registerAsyncHelper;
   exports.unregisterHelper = unregisterHelper;
   var helpers = exports.helpers = {};
+  /**
+   @module @ember/test
+  */
 
   /**
     `registerHelper` is used to register a test helper that will be injected
@@ -2167,7 +2174,8 @@ enifed('ember-testing/test/helpers', ['exports', 'ember-testing/test/promise'],
     ```
   
     @public
-    @for Ember.Test
+    @for @ember/test
+    @static
     @method registerHelper
     @param {String} name The name of the helper method to add.
     @param {Function} helperMethod
@@ -2215,7 +2223,7 @@ enifed('ember-testing/test/helpers', ['exports', 'ember-testing/test/promise'],
     ```
   
     @public
-    @for Ember.Test
+    @for @ember/test
     @method registerAsyncHelper
     @param {String} name The name of the helper method to add.
     @param {Function} helperMethod
@@ -2239,6 +2247,8 @@ enifed('ember-testing/test/helpers', ['exports', 'ember-testing/test/promise'],
   
     @public
     @method unregisterHelper
+    @static
+    @for @ember/test
     @param {String} name The helper to remove.
   */
   function unregisterHelper(name) {
@@ -2446,6 +2456,9 @@ enifed('ember-testing/test/waiters', ['exports', 'ember-debug'], function (expor
   exports.checkWaiters = checkWaiters;
 
 
+  /**
+   @module @ember/test
+  */
   var contexts = [];
   var callbacks = [];
 
@@ -2474,7 +2487,8 @@ enifed('ember-testing/test/waiters', ['exports', 'ember-debug'], function (expor
      ```
   
      @public
-     @for Ember.Test
+     @for @ember/test
+     @static
      @method registerWaiter
      @param {Object} context (optional)
      @param {Function} callback
@@ -2497,7 +2511,8 @@ enifed('ember-testing/test/waiters', ['exports', 'ember-debug'], function (expor
      registered with `registerWaiter`.
   
      @public
-     @for Ember.Test
+     @for @ember/test
+     @static
      @method unregisterWaiter
      @param {Object} context (optional)
      @param {Function} callback
@@ -2528,7 +2543,7 @@ enifed('ember-testing/test/waiters', ['exports', 'ember-debug'], function (expor
     infrastructure.
   
     @public
-    @for Ember.Test
+    @for @ember/test
     @static
     @method checkWaiters
   */