@angular/core 14.1.1 → 14.2.0-next.0

package/fesm2020/testing.mjs

@@ -1,10 +1,10 @@
 /**
- * @license Angular v14.1.1
+ * @license Angular v14.2.0-next.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
 
-import { getDebugNode as getDebugNode$1, RendererFactory2 as RendererFactory2$1, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetInjectableDef, resolveForwardRef as resolveForwardRef$1, ɵNG_COMP_DEF, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID as LOCALE_ID$1, ɵDEFAULT_LOCALE_ID, ɵsetLocaleId, ɵRender3ComponentFactory, ɵcompileComponent, ɵNG_DIR_DEF, ɵcompileDirective, ɵNG_PIPE_DEF, ɵcompilePipe, ɵNG_MOD_DEF, ɵtransitiveScopesFor, ɵpatchComponentDefWithScope, ɵNG_INJ_DEF, ɵcompileNgModuleDefs, NgZone, Compiler, COMPILER_OPTIONS, ɵNgModuleFactory, ModuleWithComponentFactories, InjectionToken as InjectionToken$1, Injector as Injector$1, InjectFlags as InjectFlags$1, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵsetUnknownElementStrictMode as ɵsetUnknownElementStrictMode$1, ɵsetUnknownPropertyStrictMode as ɵsetUnknownPropertyStrictMode$1, ɵgetUnknownElementStrictMode as ɵgetUnknownElementStrictMode$1, ɵgetUnknownPropertyStrictMode as ɵgetUnknownPropertyStrictMode$1, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
+import { getDebugNode as getDebugNode$1, RendererFactory2 as RendererFactory2$1, InjectionToken as InjectionToken$1, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetInjectableDef, resolveForwardRef as resolveForwardRef$1, ɵNG_COMP_DEF, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID as LOCALE_ID$1, ɵDEFAULT_LOCALE_ID, ɵsetLocaleId, ɵRender3ComponentFactory, ɵcompileComponent, ɵNG_DIR_DEF, ɵcompileDirective, ɵNG_PIPE_DEF, ɵcompilePipe, ɵNG_MOD_DEF, ɵtransitiveScopesFor, ɵpatchComponentDefWithScope, ɵNG_INJ_DEF, ɵcompileNgModuleDefs, NgZone, Compiler, COMPILER_OPTIONS, ɵNgModuleFactory, ModuleWithComponentFactories, Injector as Injector$1, InjectFlags as InjectFlags$1, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵsetUnknownElementStrictMode as ɵsetUnknownElementStrictMode$1, ɵsetUnknownPropertyStrictMode as ɵsetUnknownPropertyStrictMode$1, ɵgetUnknownElementStrictMode as ɵgetUnknownElementStrictMode$1, ɵgetUnknownPropertyStrictMode as ɵgetUnknownPropertyStrictMode$1, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
 import { ResourceLoader } from '@angular/compiler';
 import { Subject, Subscription } from 'rxjs';
 
@@ -413,6 +413,37 @@ function flushMicrotasks() {
     throw new Error(fakeAsyncTestModuleNotLoadedErrorMessage);
 }
 
+/**
+ * @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
+ */
+/** Whether test modules should be torn down by default. */
+const TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT = true;
+/** Whether unknown elements in templates should throw by default. */
+const THROW_ON_UNKNOWN_ELEMENTS_DEFAULT = false;
+/** Whether unknown properties in templates should throw by default. */
+const THROW_ON_UNKNOWN_PROPERTIES_DEFAULT = false;
+/**
+ * An abstract class for inserting the root test component element in a platform independent way.
+ *
+ * @publicApi
+ */
+class TestComponentRenderer {
+    insertRootElement(rootElementId) { }
+    removeAllRootElements() { }
+}
+/**
+ * @publicApi
+ */
+const ComponentFixtureAutoDetect = new InjectionToken$1('ComponentFixtureAutoDetect');
+/**
+ * @publicApi
+ */
+const ComponentFixtureNoNgZone = new InjectionToken$1('ComponentFixtureNoNgZone');
+
 /**
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -7618,7 +7649,7 @@ class Version {
 /**
  * @publicApi
  */
-const VERSION = new Version('14.1.1');
+const VERSION = new Version('14.2.0-next.0');
 
 /**
  * @license
@@ -25237,7 +25268,7 @@ function assertNoStandaloneComponents(types, resolver, location) {
         }
     });
 }
-class R3TestBedCompiler {
+class TestBedCompiler {
     constructor(platform, additionalModuleTypes) {
         this.platform = platform;
         this.additionalModuleTypes = additionalModuleTypes;
@@ -26038,49 +26069,23 @@ class R3TestCompiler {
  * 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. */
-const TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT = true;
-/** Whether unknown elements in templates should throw by default. */
-const THROW_ON_UNKNOWN_ELEMENTS_DEFAULT = false;
-/** Whether unknown properties in templates should throw by default. */
-const THROW_ON_UNKNOWN_PROPERTIES_DEFAULT = false;
+let _nextRootElementId = 0;
 /**
- * An abstract class for inserting the root test component element in a platform independent way.
+ * Returns a singleton of the `TestBed` class.
  *
  * @publicApi
  */
-class TestComponentRenderer {
-    insertRootElement(rootElementId) { }
-    removeAllRootElements() { }
+function getTestBed() {
+    return TestBedImpl.INSTANCE;
 }
-/**
- * @publicApi
- */
-const ComponentFixtureAutoDetect = new InjectionToken$1('ComponentFixtureAutoDetect');
-/**
- * @publicApi
- */
-const ComponentFixtureNoNgZone = new InjectionToken$1('ComponentFixtureNoNgZone');
-
-/**
- * @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
- */
-let _nextRootElementId = 0;
 /**
  * @description
  * Configures and initializes environment for unit testing and provides methods for
  * creating components and services in unit tests.
  *
  * TestBed is the primary api for writing unit tests for Angular applications and libraries.
- *
- * Note: Use `TestBed` in tests. It will be set to either `TestBedViewEngine` or `TestBedRender3`
- * according to the compiler used.
  */
-class TestBedRender3 {
+class TestBedImpl {
     constructor() {
         // Properties
         this.platform = null;
@@ -26088,7 +26093,15 @@ class TestBedRender3 {
         this._compiler = null;
         this._testModuleRef = null;
         this._activeFixtures = [];
-        this._globalCompilationChecked = false;
+        /**
+         * Internal-only flag to indicate whether a module
+         * scoping queue has been checked and flushed already.
+         * @nodoc
+         */
+        this.globalCompilationChecked = false;
+    }
+    static get INSTANCE() {
+        return TestBedImpl._INSTANCE = TestBedImpl._INSTANCE || new TestBedImpl();
     }
     /**
      * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
@@ -26104,7 +26117,7 @@ class TestBedRender3 {
      * @publicApi
      */
     static initTestEnvironment(ngModule, platform, options) {
-        const testBed = _getTestBedRender3();
+        const testBed = TestBedImpl.INSTANCE;
         testBed.initTestEnvironment(ngModule, platform, options);
         return testBed;
     }
@@ -26114,19 +26127,17 @@ class TestBedRender3 {
      * @publicApi
      */
     static resetTestEnvironment() {
-        _getTestBedRender3().resetTestEnvironment();
+        TestBedImpl.INSTANCE.resetTestEnvironment();
     }
     static configureCompiler(config) {
-        _getTestBedRender3().configureCompiler(config);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.configureCompiler(config);
     }
     /**
      * Allows overriding default providers, directives, pipes, modules of the test injector,
      * which are defined in test_injector.js
      */
     static configureTestingModule(moduleDef) {
-        _getTestBedRender3().configureTestingModule(moduleDef);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.configureTestingModule(moduleDef);
     }
     /**
      * Compile components with a `templateUrl` for the test's NgModule.
@@ -26134,27 +26145,22 @@ class TestBedRender3 {
      * as fetching urls is asynchronous.
      */
     static compileComponents() {
-        return _getTestBedRender3().compileComponents();
+        return TestBedImpl.INSTANCE.compileComponents();
     }
     static overrideModule(ngModule, override) {
-        _getTestBedRender3().overrideModule(ngModule, override);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideModule(ngModule, override);
     }
     static overrideComponent(component, override) {
-        _getTestBedRender3().overrideComponent(component, override);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideComponent(component, override);
     }
     static overrideDirective(directive, override) {
-        _getTestBedRender3().overrideDirective(directive, override);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideDirective(directive, override);
     }
     static overridePipe(pipe, override) {
-        _getTestBedRender3().overridePipe(pipe, override);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overridePipe(pipe, override);
     }
     static overrideTemplate(component, template) {
-        _getTestBedRender3().overrideComponent(component, { set: { template, templateUrl: null } });
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideTemplate(component, template);
     }
     /**
      * Overrides the template of the given component, compiling the template
@@ -26163,32 +26169,32 @@ class TestBedRender3 {
      * Note: This works for JIT and AOTed components as well.
      */
     static overrideTemplateUsingTestingModule(component, template) {
-        _getTestBedRender3().overrideTemplateUsingTestingModule(component, template);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideTemplateUsingTestingModule(component, template);
     }
     static overrideProvider(token, provider) {
-        _getTestBedRender3().overrideProvider(token, provider);
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.overrideProvider(token, provider);
     }
     static inject(token, notFoundValue, flags) {
-        return _getTestBedRender3().inject(token, notFoundValue, flags);
+        return TestBedImpl.INSTANCE.inject(token, notFoundValue, flags);
     }
     /** @deprecated from v9.0.0 use TestBed.inject */
     static get(token, notFoundValue = Injector$1.THROW_IF_NOT_FOUND, flags = InjectFlags$1.Default) {
-        return _getTestBedRender3().inject(token, notFoundValue, flags);
+        return TestBedImpl.INSTANCE.inject(token, notFoundValue, flags);
     }
     static createComponent(component) {
-        return _getTestBedRender3().createComponent(component);
+        return TestBedImpl.INSTANCE.createComponent(component);
     }
     static resetTestingModule() {
-        _getTestBedRender3().resetTestingModule();
-        return TestBedRender3;
+        return TestBedImpl.INSTANCE.resetTestingModule();
+    }
+    static execute(tokens, fn, context) {
+        return TestBedImpl.INSTANCE.execute(tokens, fn, context);
     }
-    static shouldTearDownTestingModule() {
-        return _getTestBedRender3().shouldTearDownTestingModule();
+    static get platform() {
+        return TestBedImpl.INSTANCE.platform;
     }
-    static tearDownTestingModule() {
-        _getTestBedRender3().tearDownTestingModule();
+    static get ngModule() {
+        return TestBedImpl.INSTANCE.ngModule;
     }
     /**
      * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
@@ -26207,12 +26213,12 @@ class TestBedRender3 {
         if (this.platform || this.ngModule) {
             throw new Error('Cannot set base providers because it has already been called');
         }
-        TestBedRender3._environmentTeardownOptions = options?.teardown;
-        TestBedRender3._environmentErrorOnUnknownElementsOption = options?.errorOnUnknownElements;
-        TestBedRender3._environmentErrorOnUnknownPropertiesOption = options?.errorOnUnknownProperties;
+        TestBedImpl._environmentTeardownOptions = options?.teardown;
+        TestBedImpl._environmentErrorOnUnknownElementsOption = options?.errorOnUnknownElements;
+        TestBedImpl._environmentErrorOnUnknownPropertiesOption = options?.errorOnUnknownProperties;
         this.platform = platform;
         this.ngModule = ngModule;
-        this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
+        this._compiler = new TestBedCompiler(this.platform, this.ngModule);
         // TestBed does not have an API which can reliably detect the start of a test, and thus could be
         // used to track the state of the NgModule registry and reset it correctly. Instead, when we
         // know we're in a testing scenario, we disable the check for duplicate NgModule registration
@@ -26229,7 +26235,7 @@ class TestBedRender3 {
         this._compiler = null;
         this.platform = null;
         this.ngModule = null;
-        TestBedRender3._environmentTeardownOptions = undefined;
+        TestBedImpl._environmentTeardownOptions = undefined;
         ɵsetAllowDuplicateNgModuleIdsForTest(false);
     }
     resetTestingModule() {
@@ -26238,7 +26244,7 @@ class TestBedRender3 {
         if (this._compiler !== null) {
             this.compiler.restoreOriginalState();
         }
-        this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
+        this._compiler = new TestBedCompiler(this.platform, this.ngModule);
         // Restore the previous value of the "error on unknown elements" option
         ɵsetUnknownElementStrictMode$1(this._previousErrorOnUnknownElementsOption ?? THROW_ON_UNKNOWN_ELEMENTS_DEFAULT);
         // Restore the previous value of the "error on unknown properties" option
@@ -26262,6 +26268,7 @@ class TestBedRender3 {
                 this._instanceErrorOnUnknownPropertiesOption = undefined;
             }
         }
+        return this;
     }
     configureCompiler(config) {
         if (config.useJit != null) {
@@ -26270,6 +26277,7 @@ class TestBedRender3 {
         if (config.providers !== undefined) {
             this.compiler.setCompilerProviders(config.providers);
         }
+        return this;
     }
     configureTestingModule(moduleDef) {
         this.assertNotInstantiated('R3TestBed.configureTestingModule', 'configure the test module');
@@ -26290,12 +26298,13 @@ class TestBedRender3 {
         this._previousErrorOnUnknownPropertiesOption = ɵgetUnknownPropertyStrictMode$1();
         ɵsetUnknownPropertyStrictMode$1(this.shouldThrowErrorOnUnknownProperties());
         this.compiler.configureTestingModule(moduleDef);
+        return this;
     }
     compileComponents() {
         return this.compiler.compileComponents();
     }
     inject(token, notFoundValue, flags) {
-        if (token === TestBedRender3) {
+        if (token === TestBed) {
             return this;
         }
         const UNDEFINED = {};
@@ -26314,22 +26323,27 @@ class TestBedRender3 {
     overrideModule(ngModule, override) {
         this.assertNotInstantiated('overrideModule', 'override module metadata');
         this.compiler.overrideModule(ngModule, override);
+        return this;
     }
     overrideComponent(component, override) {
         this.assertNotInstantiated('overrideComponent', 'override component metadata');
         this.compiler.overrideComponent(component, override);
+        return this;
     }
     overrideTemplateUsingTestingModule(component, template) {
         this.assertNotInstantiated('R3TestBed.overrideTemplateUsingTestingModule', 'Cannot override template when the test module has already been instantiated');
         this.compiler.overrideTemplateUsingTestingModule(component, template);
+        return this;
     }
     overrideDirective(directive, override) {
         this.assertNotInstantiated('overrideDirective', 'override directive metadata');
         this.compiler.overrideDirective(directive, override);
+        return this;
     }
     overridePipe(pipe, override) {
         this.assertNotInstantiated('overridePipe', 'override pipe metadata');
         this.compiler.overridePipe(pipe, override);
+        return this;
     }
     /**
      * Overwrites all providers for the given token with the given provider definition.
@@ -26337,6 +26351,10 @@ class TestBedRender3 {
     overrideProvider(token, provider) {
         this.assertNotInstantiated('overrideProvider', 'override provider');
         this.compiler.overrideProvider(token, provider);
+        return this;
+    }
+    overrideTemplate(component, template) {
+        return this.overrideComponent(component, { set: { template, templateUrl: null } });
     }
     createComponent(type) {
         const testComponentRenderer = this.inject(TestComponentRenderer);
@@ -26401,10 +26419,10 @@ class TestBedRender3 {
     checkGlobalCompilationFinished() {
         // Checking _testNgModuleRef is null should not be necessary, but is left in as an additional
         // guard that compilations queued in tests (after instantiation) are never flushed accidentally.
-        if (!this._globalCompilationChecked && this._testModuleRef === null) {
+        if (!this.globalCompilationChecked && this._testModuleRef === null) {
             ɵflushModuleScopingQueueAsMuchAsPossible();
         }
-        this._globalCompilationChecked = true;
+        this.globalCompilationChecked = true;
     }
     destroyActiveFixtures() {
         let errorCount = 0;
@@ -26428,7 +26446,7 @@ class TestBedRender3 {
     }
     shouldRethrowTeardownErrors() {
         const instanceOptions = this._instanceTeardownOptions;
-        const environmentOptions = TestBedRender3._environmentTeardownOptions;
+        const environmentOptions = TestBedImpl._environmentTeardownOptions;
         // If the new teardown behavior hasn't been configured, preserve the old behavior.
         if (!instanceOptions && !environmentOptions) {
             return TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT;
@@ -26440,18 +26458,17 @@ class TestBedRender3 {
     shouldThrowErrorOnUnknownElements() {
         // Check if a configuration has been provided to throw when an unknown element is found
         return this._instanceErrorOnUnknownElementsOption ??
-            TestBedRender3._environmentErrorOnUnknownElementsOption ??
-            THROW_ON_UNKNOWN_ELEMENTS_DEFAULT;
+            TestBedImpl._environmentErrorOnUnknownElementsOption ?? THROW_ON_UNKNOWN_ELEMENTS_DEFAULT;
     }
     shouldThrowErrorOnUnknownProperties() {
         // Check if a configuration has been provided to throw when an unknown property is found
         return this._instanceErrorOnUnknownPropertiesOption ??
-            TestBedRender3._environmentErrorOnUnknownPropertiesOption ??
+            TestBedImpl._environmentErrorOnUnknownPropertiesOption ??
             THROW_ON_UNKNOWN_PROPERTIES_DEFAULT;
     }
     shouldTearDownTestingModule() {
         return this._instanceTeardownOptions?.destroyAfterEach ??
-            TestBedRender3._environmentTeardownOptions?.destroyAfterEach ??
+            TestBedImpl._environmentTeardownOptions?.destroyAfterEach ??
             TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT;
     }
     tearDownTestingModule() {
@@ -26481,18 +26498,7 @@ class TestBedRender3 {
         }
     }
 }
-let testBed;
-function _getTestBedRender3() {
-    return testBed = testBed || new TestBedRender3();
-}
-
-/**
- * @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
- */
+TestBedImpl._INSTANCE = null;
 /**
  * @description
  * Configures and initializes environment for unit testing and provides methods for
@@ -26500,20 +26506,9 @@ function _getTestBedRender3() {
  *
  * `TestBed` is the primary api for writing unit tests for Angular applications and libraries.
  *
- * Note: Use `TestBed` in tests. It will be set to either `TestBedViewEngine` or `TestBedRender3`
- * according to the compiler used.
- *
- * @publicApi
- */
-const TestBed = TestBedRender3;
-/**
- * Returns a singleton of the applicable `TestBed`.
- *
- * It will be either an instance of `TestBedViewEngine` or `TestBedRender3`.
- *
  * @publicApi
  */
-const getTestBed = _getTestBedRender3;
+const TestBed = TestBedImpl;
 /**
  * Allows injecting dependencies in `beforeEach()` and `it()`. Note: this function
  * (imported from the `@angular/core/testing` package) can **only** be used to inject dependencies
@@ -26537,7 +26532,7 @@ const getTestBed = _getTestBedRender3;
  * @publicApi
  */
 function inject(tokens, fn) {
-    const testBed = getTestBed();
+    const testBed = TestBedImpl.INSTANCE;
     // Not using an arrow function to preserve context passed from call site
     return function () {
         return testBed.execute(tokens, fn, this);
@@ -26553,7 +26548,7 @@ class InjectSetupWrapper {
     _addModule() {
         const moduleDef = this._moduleDef();
         if (moduleDef) {
-            getTestBed().configureTestingModule(moduleDef);
+            TestBedImpl.configureTestingModule(moduleDef);
         }
     }
     inject(tokens, fn) {
@@ -26569,7 +26564,7 @@ function withModule(moduleDef, fn) {
     if (fn) {
         // Not using an arrow function to preserve context passed from call site
         return function () {
-            const testBed = getTestBed();
+            const testBed = TestBedImpl.INSTANCE;
             if (moduleDef) {
                 testBed.configureTestingModule(moduleDef);
             }
@@ -26599,9 +26594,9 @@ if (_global.afterEach) {
 }
 function getCleanupHook(expectedTeardownValue) {
     return () => {
-        // TODO(alxhub): find a better type here
-        if (TestBed.shouldTearDownTestingModule() === expectedTeardownValue) {
-            TestBed.resetTestingModule();
+        const testBed = TestBedImpl.INSTANCE;
+        if (testBed.shouldTearDownTestingModule() === expectedTeardownValue) {
+            testBed.resetTestingModule();
             resetFakeAsyncZone();
         }
     };