@angular/core 12.1.0-next.3 → 12.1.0

package/bundles/core-testing.umd.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.1.0-next.3
+ * @license Angular v12.1.0
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -647,10 +647,16 @@
                 r[k] = a[j];
         return r;
     }
-    function __spreadArray(to, from) {
-        for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
-            to[j] = from[i];
-        return to;
+    function __spreadArray(to, from, pack) {
+        if (pack || arguments.length === 2)
+            for (var i = 0, l = from.length, ar; i < l; i++) {
+                if (ar || !(i in from)) {
+                    if (!ar)
+                        ar = Array.prototype.slice.call(from, 0, i);
+                    ar[i] = from[i];
+                }
+            }
+        return to.concat(ar || from);
     }
     function __await(v) {
         return this instanceof __await ? (this.v = v, this) : new __await(v);
@@ -733,40 +739,6 @@
         return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
     }
 
-    /**
-     * @license
-     * Copyright Google LLC All Rights Reserved.
-     *
-     * Use of this source code is governed by an MIT-style license that can be
-     * found in the LICENSE file at https://angular.io/license
-     */
-    /**
-     * Injectable completer that allows signaling completion of an asynchronous test. Used internally.
-     */
-    var AsyncTestCompleter = /** @class */ (function () {
-        function AsyncTestCompleter() {
-            var _this = this;
-            this._promise = new Promise(function (res, rej) {
-                _this._resolve = res;
-                _this._reject = rej;
-            });
-        }
-        AsyncTestCompleter.prototype.done = function (value) {
-            this._resolve(value);
-        };
-        AsyncTestCompleter.prototype.fail = function (error, stackTrace) {
-            this._reject(error);
-        };
-        Object.defineProperty(AsyncTestCompleter.prototype, "promise", {
-            get: function () {
-                return this._promise;
-            },
-            enumerable: false,
-            configurable: true
-        });
-        return AsyncTestCompleter;
-    }());
-
     /**
      * @license
      * Copyright Google LLC All Rights Reserved.
@@ -1962,6 +1934,11 @@
      * Use of this source code is governed by an MIT-style license that can be
      * found in the LICENSE file at https://angular.io/license
      */
+    /**
+     * Whether test modules should be torn down by default.
+     * Currently disabled for backwards-compatibility reasons.
+     */
+    var TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT = false;
     /**
      * An abstract class for inserting the root test component element in a platform independent way.
      *
@@ -1971,6 +1948,7 @@
         function TestComponentRenderer() {
         }
         TestComponentRenderer.prototype.insertRootElement = function (rootElementId) { };
+        TestComponentRenderer.prototype.removeAllRootElements = function () { };
         return TestComponentRenderer;
     }());
     /**
@@ -2023,9 +2001,9 @@
          *
          * @publicApi
          */
-        TestBedRender3.initTestEnvironment = function (ngModule, platform, aotSummaries) {
+        TestBedRender3.initTestEnvironment = function (ngModule, platform, summariesOrOptions) {
             var testBed = _getTestBedRender3();
-            testBed.initTestEnvironment(ngModule, platform, aotSummaries);
+            testBed.initTestEnvironment(ngModule, platform, summariesOrOptions);
             return testBed;
         };
         /**
@@ -2106,6 +2084,12 @@
             _getTestBedRender3().resetTestingModule();
             return TestBedRender3;
         };
+        TestBedRender3.shouldTearDownTestingModule = function () {
+            return _getTestBedRender3().shouldTearDownTestingModule();
+        };
+        TestBedRender3.tearDownTestingModule = function () {
+            _getTestBedRender3().tearDownTestingModule();
+        };
         /**
          * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
          * angular module. These are common to every test in the suite.
@@ -2119,10 +2103,14 @@
          *
          * @publicApi
          */
-        TestBedRender3.prototype.initTestEnvironment = function (ngModule, platform, aotSummaries) {
+        TestBedRender3.prototype.initTestEnvironment = function (ngModule, platform, summariesOrOptions) {
             if (this.platform || this.ngModule) {
                 throw new Error('Cannot set base providers because it has already been called');
             }
+            // If `summariesOrOptions` is a function, it means that it's
+            // an AOT summaries factory which Ivy doesn't support.
+            TestBedRender3._environmentTeardownOptions =
+                typeof summariesOrOptions === 'function' ? undefined : summariesOrOptions === null || summariesOrOptions === void 0 ? void 0 : summariesOrOptions.teardown;
             this.platform = platform;
             this.ngModule = ngModule;
             this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
@@ -2137,6 +2125,7 @@
             this._compiler = null;
             this.platform = null;
             this.ngModule = null;
+            TestBedRender3._environmentTeardownOptions = undefined;
         };
         TestBedRender3.prototype.resetTestingModule = function () {
             this.checkGlobalCompilationFinished();
@@ -2145,8 +2134,23 @@
                 this.compiler.restoreOriginalState();
             }
             this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
-            this._testModuleRef = null;
-            this.destroyActiveFixtures();
+            // We have to chain a couple of try/finally blocks, because each step can
+            // throw errors and we don't want it to interrupt the next step and we also
+            // want an error to be thrown at the end.
+            try {
+                this.destroyActiveFixtures();
+            }
+            finally {
+                try {
+                    if (this.shouldTearDownTestingModule()) {
+                        this.tearDownTestingModule();
+                    }
+                }
+                finally {
+                    this._testModuleRef = null;
+                    this._instanceTeardownOptions = undefined;
+                }
+            }
         };
         TestBedRender3.prototype.configureCompiler = function (config) {
             if (config.useJit != null) {
@@ -2158,6 +2162,9 @@
         };
         TestBedRender3.prototype.configureTestingModule = function (moduleDef) {
             this.assertNotInstantiated('R3TestBed.configureTestingModule', 'configure the test module');
+            // Always re-assign the teardown options, even if they're undefined.
+            // This ensures that we don't carry the options between tests.
+            this._instanceTeardownOptions = moduleDef.teardown;
             this.compiler.configureTestingModule(moduleDef);
         };
         TestBedRender3.prototype.compileComponents = function () {
@@ -2288,11 +2295,13 @@
             this._globalCompilationChecked = true;
         };
         TestBedRender3.prototype.destroyActiveFixtures = function () {
+            var errorCount = 0;
             this._activeFixtures.forEach(function (fixture) {
                 try {
                     fixture.destroy();
                 }
                 catch (e) {
+                    errorCount++;
                     console.error('Error during cleanup of component', {
                         component: fixture.componentInstance,
                         stacktrace: e,
@@ -2300,6 +2309,52 @@
                 }
             });
             this._activeFixtures = [];
+            if (errorCount > 0 && this.shouldRethrowTeardownErrors()) {
+                throw Error(errorCount + " " + (errorCount === 1 ? 'component' : 'components') + " " +
+                    "threw errors during cleanup");
+            }
+        };
+        TestBedRender3.prototype.shouldRethrowTeardownErrors = function () {
+            var _a, _b;
+            var instanceOptions = this._instanceTeardownOptions;
+            var environmentOptions = TestBedRender3._environmentTeardownOptions;
+            // If the new teardown behavior hasn't been configured, preserve the old behavior.
+            if (!instanceOptions && !environmentOptions) {
+                return false;
+            }
+            // Otherwise use the configured behavior or default to rethrowing.
+            return (_b = (_a = instanceOptions === null || instanceOptions === void 0 ? void 0 : instanceOptions.rethrowErrors) !== null && _a !== void 0 ? _a : environmentOptions === null || environmentOptions === void 0 ? void 0 : environmentOptions.rethrowErrors) !== null && _b !== void 0 ? _b : true;
+        };
+        TestBedRender3.prototype.shouldTearDownTestingModule = function () {
+            var _a, _b, _c, _d;
+            return (_d = (_b = (_a = this._instanceTeardownOptions) === null || _a === void 0 ? void 0 : _a.destroyAfterEach) !== null && _b !== void 0 ? _b : (_c = TestBedRender3._environmentTeardownOptions) === null || _c === void 0 ? void 0 : _c.destroyAfterEach) !== null && _d !== void 0 ? _d : TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT;
+        };
+        TestBedRender3.prototype.tearDownTestingModule = function () {
+            var _a;
+            // If the module ref has already been destroyed, we won't be able to get a test renderer.
+            if (this._testModuleRef === null) {
+                return;
+            }
+            // Resolve the renderer ahead of time, because we want to remove the root elements as the very
+            // last step, but the injector will be destroyed as a part of the module ref destruction.
+            var testRenderer = this.inject(TestComponentRenderer);
+            try {
+                this._testModuleRef.destroy();
+            }
+            catch (e) {
+                if (this.shouldRethrowTeardownErrors()) {
+                    throw e;
+                }
+                else {
+                    console.error('Error during cleanup of a testing module', {
+                        component: this._testModuleRef.instance,
+                        stacktrace: e,
+                    });
+                }
+            }
+            finally {
+                (_a = testRenderer.removeAllRootElements) === null || _a === void 0 ? void 0 : _a.call(testRenderer);
+            }
         };
         return TestBedRender3;
     }());
@@ -2424,9 +2479,9 @@
          * Test modules and platforms for individual platforms are available from
          * '@angular/<platform_name>/testing'.
          */
-        TestBedViewEngine.initTestEnvironment = function (ngModule, platform, aotSummaries) {
+        TestBedViewEngine.initTestEnvironment = function (ngModule, platform, summariesOrOptions) {
             var testBed = _getTestBedViewEngine();
-            testBed.initTestEnvironment(ngModule, platform, aotSummaries);
+            testBed.initTestEnvironment(ngModule, platform, summariesOrOptions);
             return testBed;
         };
         /**
@@ -2509,6 +2564,12 @@
         TestBedViewEngine.createComponent = function (component) {
             return _getTestBedViewEngine().createComponent(component);
         };
+        TestBedViewEngine.shouldTearDownTestingModule = function () {
+            return _getTestBedViewEngine().shouldTearDownTestingModule();
+        };
+        TestBedViewEngine.tearDownTestingModule = function () {
+            _getTestBedViewEngine().tearDownTestingModule();
+        };
         /**
          * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
          * angular module. These are common to every test in the suite.
@@ -2520,14 +2581,19 @@
          * Test modules and platforms for individual platforms are available from
          * '@angular/<platform_name>/testing'.
          */
-        TestBedViewEngine.prototype.initTestEnvironment = function (ngModule, platform, aotSummaries) {
+        TestBedViewEngine.prototype.initTestEnvironment = function (ngModule, platform, summariesOrOptions) {
             if (this.platform || this.ngModule) {
                 throw new Error('Cannot set base providers because it has already been called');
             }
             this.platform = platform;
             this.ngModule = ngModule;
-            if (aotSummaries) {
-                this._testEnvAotSummaries = aotSummaries;
+            if (typeof summariesOrOptions === 'function') {
+                this._testEnvAotSummaries = summariesOrOptions;
+                TestBedViewEngine._environmentTeardownOptions = undefined;
+            }
+            else {
+                this._testEnvAotSummaries = (summariesOrOptions === null || summariesOrOptions === void 0 ? void 0 : summariesOrOptions.aotSummaries) || (function () { return []; });
+                TestBedViewEngine._environmentTeardownOptions = summariesOrOptions === null || summariesOrOptions === void 0 ? void 0 : summariesOrOptions.teardown;
             }
         };
         /**
@@ -2538,6 +2604,7 @@
             this.platform = null;
             this.ngModule = null;
             this._testEnvAotSummaries = function () { return []; };
+            TestBedViewEngine._environmentTeardownOptions = undefined;
         };
         TestBedViewEngine.prototype.resetTestingModule = function () {
             core.ɵclearOverrides();
@@ -2550,49 +2617,56 @@
             this._pipeOverrides = [];
             this._isRoot = true;
             this._rootProviderOverrides = [];
-            this._moduleRef = null;
             this._moduleFactory = null;
             this._compilerOptions = [];
             this._providers = [];
             this._declarations = [];
             this._imports = [];
             this._schemas = [];
-            this._instantiated = false;
-            this._activeFixtures.forEach(function (fixture) {
+            // We have to chain a couple of try/finally blocks, because each step can
+            // throw errors and we don't want it to interrupt the next step and we also
+            // want an error to be thrown at the end.
+            try {
+                this.destroyActiveFixtures();
+            }
+            finally {
                 try {
-                    fixture.destroy();
+                    if (this.shouldTearDownTestingModule()) {
+                        this.tearDownTestingModule();
+                    }
                 }
-                catch (e) {
-                    console.error('Error during cleanup of component', {
-                        component: fixture.componentInstance,
-                        stacktrace: e,
-                    });
+                finally {
+                    this._moduleRef = null;
+                    this._instanceTeardownOptions = undefined;
+                    this._instantiated = false;
                 }
-            });
-            this._activeFixtures = [];
+            }
         };
         TestBedViewEngine.prototype.configureCompiler = function (config) {
             this._assertNotInstantiated('TestBed.configureCompiler', 'configure the compiler');
             this._compilerOptions.push(config);
         };
         TestBedViewEngine.prototype.configureTestingModule = function (moduleDef) {
-            var _a, _b, _c, _d;
+            var _f, _g, _h, _j;
             this._assertNotInstantiated('TestBed.configureTestingModule', 'configure the test module');
             if (moduleDef.providers) {
-                (_a = this._providers).push.apply(_a, __spreadArray([], __read(moduleDef.providers)));
+                (_f = this._providers).push.apply(_f, __spreadArray([], __read(moduleDef.providers)));
             }
             if (moduleDef.declarations) {
-                (_b = this._declarations).push.apply(_b, __spreadArray([], __read(moduleDef.declarations)));
+                (_g = this._declarations).push.apply(_g, __spreadArray([], __read(moduleDef.declarations)));
             }
             if (moduleDef.imports) {
-                (_c = this._imports).push.apply(_c, __spreadArray([], __read(moduleDef.imports)));
+                (_h = this._imports).push.apply(_h, __spreadArray([], __read(moduleDef.imports)));
             }
             if (moduleDef.schemas) {
-                (_d = this._schemas).push.apply(_d, __spreadArray([], __read(moduleDef.schemas)));
+                (_j = this._schemas).push.apply(_j, __spreadArray([], __read(moduleDef.schemas)));
             }
             if (moduleDef.aotSummaries) {
                 this._aotSummaries.push(moduleDef.aotSummaries);
             }
+            // Always re-assign the teardown options, even if they're undefined.
+            // This ensures that we don't carry the options between tests.
+            this._instanceTeardownOptions = moduleDef.teardown;
         };
         TestBedViewEngine.prototype.compileComponents = function () {
             var _this = this;
@@ -2606,7 +2680,7 @@
             });
         };
         TestBedViewEngine.prototype._initIfNeeded = function () {
-            var e_1, _a;
+            var e_1, _f;
             if (this._instantiated) {
                 return;
             }
@@ -2628,8 +2702,8 @@
                 }
             }
             try {
-                for (var _b = __values(this._templateOverrides), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var _d = _c.value, component = _d.component, templateOf = _d.templateOf;
+                for (var _g = __values(this._templateOverrides), _h = _g.next(); !_h.done; _h = _g.next()) {
+                    var _j = _h.value, component = _j.component, templateOf = _j.templateOf;
                     var compFactory = this._compiler.getComponentFactory(templateOf);
                     core.ɵoverrideComponentView(component, compFactory);
                 }
@@ -2637,7 +2711,7 @@
             catch (e_1_1) { e_1 = { error: e_1_1 }; }
             finally {
                 try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                    if (_h && !_h.done && (_f = _g.return)) _f.call(_g);
                 }
                 finally { if (e_1) throw e_1.error; }
             }
@@ -2655,7 +2729,7 @@
             this._instantiated = true;
         };
         TestBedViewEngine.prototype._createCompilerAndModule = function () {
-            var e_2, _a;
+            var e_2, _f;
             var _this = this;
             var providers = this._providers.concat([{ provide: TestBed, useValue: this }]);
             var declarations = __spreadArray(__spreadArray([], __read(this._declarations)), __read(this._templateOverrides.map(function (entry) { return entry.templateOf; })));
@@ -2689,15 +2763,15 @@
             var compilerFactory = this.platform.injector.get(TestingCompilerFactory);
             this._compiler = compilerFactory.createTestingCompiler(this._compilerOptions);
             try {
-                for (var _b = __values(__spreadArray([this._testEnvAotSummaries], __read(this._aotSummaries))), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var summary = _c.value;
+                for (var _g = __values(__spreadArray([this._testEnvAotSummaries], __read(this._aotSummaries))), _h = _g.next(); !_h.done; _h = _g.next()) {
+                    var summary = _h.value;
                     this._compiler.loadAotSummaries(summary);
                 }
             }
             catch (e_2_1) { e_2 = { error: e_2_1 }; }
             finally {
                 try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                    if (_h && !_h.done && (_f = _g.return)) _f.call(_g);
                 }
                 finally { if (e_2) throw e_2.error; }
             }
@@ -2836,6 +2910,68 @@
             this._activeFixtures.push(fixture);
             return fixture;
         };
+        TestBedViewEngine.prototype.destroyActiveFixtures = function () {
+            var errorCount = 0;
+            this._activeFixtures.forEach(function (fixture) {
+                try {
+                    fixture.destroy();
+                }
+                catch (e) {
+                    errorCount++;
+                    console.error('Error during cleanup of component', {
+                        component: fixture.componentInstance,
+                        stacktrace: e,
+                    });
+                }
+            });
+            this._activeFixtures = [];
+            if (errorCount > 0 && this.shouldRethrowTeardownErrors()) {
+                throw Error(errorCount + " " + (errorCount === 1 ? 'component' : 'components') + " " +
+                    "threw errors during cleanup");
+            }
+        };
+        TestBedViewEngine.prototype.shouldRethrowTeardownErrors = function () {
+            var _a, _b;
+            var instanceOptions = this._instanceTeardownOptions;
+            var environmentOptions = TestBedViewEngine._environmentTeardownOptions;
+            // If the new teardown behavior hasn't been configured, preserve the old behavior.
+            if (!instanceOptions && !environmentOptions) {
+                return false;
+            }
+            // Otherwise use the configured behavior or default to rethrowing.
+            return (_b = (_a = instanceOptions === null || instanceOptions === void 0 ? void 0 : instanceOptions.rethrowErrors) !== null && _a !== void 0 ? _a : environmentOptions === null || environmentOptions === void 0 ? void 0 : environmentOptions.rethrowErrors) !== null && _b !== void 0 ? _b : true;
+        };
+        TestBedViewEngine.prototype.shouldTearDownTestingModule = function () {
+            var _a, _b, _c, _d;
+            return (_d = (_b = (_a = this._instanceTeardownOptions) === null || _a === void 0 ? void 0 : _a.destroyAfterEach) !== null && _b !== void 0 ? _b : (_c = TestBedViewEngine._environmentTeardownOptions) === null || _c === void 0 ? void 0 : _c.destroyAfterEach) !== null && _d !== void 0 ? _d : TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT;
+        };
+        TestBedViewEngine.prototype.tearDownTestingModule = function () {
+            var _a, _b, _c, _d, _e;
+            // If the module ref has already been destroyed, we won't be able to get a test renderer.
+            if (this._moduleRef === null) {
+                return;
+            }
+            // Resolve the renderer ahead of time, because we want to remove the root elements as the very
+            // last step, but the injector will be destroyed as a part of the module ref destruction.
+            var testRenderer = this.inject(TestComponentRenderer);
+            try {
+                this._moduleRef.destroy();
+            }
+            catch (e) {
+                if ((_d = (_b = (_a = this._instanceTeardownOptions) === null || _a === void 0 ? void 0 : _a.rethrowErrors) !== null && _b !== void 0 ? _b : (_c = TestBedViewEngine._environmentTeardownOptions) === null || _c === void 0 ? void 0 : _c.rethrowErrors) !== null && _d !== void 0 ? _d : true) {
+                    throw e;
+                }
+                else {
+                    console.error('Error during cleanup of a testing module', {
+                        component: this._moduleRef.instance,
+                        stacktrace: e,
+                    });
+                }
+            }
+            finally {
+                (_e = testRenderer === null || testRenderer === void 0 ? void 0 : testRenderer.removeAllRootElements) === null || _e === void 0 ? void 0 : _e.call(testRenderer);
+            }
+        };
         return TestBedViewEngine;
     }());
     /**
@@ -2880,34 +3016,14 @@
      * })
      * ```
      *
-     * Notes:
-     * - inject is currently a function because of some Traceur limitation the syntax should
-     * eventually
-     *   becomes `it('...', @Inject (object: AClass, async: AsyncTestCompleter) => { ... });`
-     *
      * @publicApi
      */
     function inject(tokens, fn) {
         var testBed = getTestBed();
-        if (tokens.indexOf(AsyncTestCompleter) >= 0) {
-            // Not using an arrow function to preserve context passed from call site
-            return function () {
-                var _this = this;
-                // Return an async test method that returns a Promise if AsyncTestCompleter is one of
-                // the injected tokens.
-                return testBed.compileComponents().then(function () {
-                    var completer = testBed.inject(AsyncTestCompleter);
-                    testBed.execute(tokens, fn, _this);
-                    return completer.promise;
-                });
-            };
-        }
-        else {
-            // Not using an arrow function to preserve context passed from call site
-            return function () {
-                return testBed.execute(tokens, fn, this);
-            };
-        }
+        // Not using an arrow function to preserve context passed from call site
+        return function () {
+            return testBed.execute(tokens, fn, this);
+        };
     }
     /**
      * @publicApi
@@ -2956,10 +3072,22 @@
     var _global = (typeof window === 'undefined' ? global : window);
     // Reset the test providers and the fake async zone before each test.
     if (_global.beforeEach) {
-        _global.beforeEach(function () {
-            TestBed.resetTestingModule();
-            resetFakeAsyncZone();
-        });
+        _global.beforeEach(getCleanupHook(false));
+    }
+    // We provide both a `beforeEach` and `afterEach`, because the updated behavior for
+    // tearing down the module is supposed to run after the test so that we can associate
+    // teardown errors with the correct test.
+    if (_global.afterEach) {
+        _global.afterEach(getCleanupHook(true));
+    }
+    function getCleanupHook(expectedTeardownValue) {
+        return function () {
+            if (TestBed.shouldTearDownTestingModule() ===
+                expectedTeardownValue) {
+                TestBed.resetTestingModule();
+                resetFakeAsyncZone();
+            }
+        };
     }
     /**
      * This API should be removed. But doing so seems to break `google3` and so it requires a bit of