@angular/core 14.0.0-next.8 → 14.0.0-rc.1

package/fesm2015/testing.mjs

@@ -1,10 +1,10 @@
 /**
- * @license Angular v14.0.0-next.8
+ * @license Angular v14.0.0-rc.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
 
-import { getDebugNode, RendererFactory2, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetInjectableDef, resolveForwardRef, ɵNG_COMP_DEF, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID, ɵ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, Injector, InjectFlags, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
+import { getDebugNode, RendererFactory2, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetInjectableDef, resolveForwardRef, ɵNG_COMP_DEF, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID, ɵ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, Injector, InjectFlags, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵsetUnknownElementStrictMode, ɵsetUnknownPropertyStrictMode, ɵgetUnknownElementStrictMode, ɵgetUnknownPropertyStrictMode, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
 import { __awaiter } from 'tslib';
 import { ResourceLoader } from '@angular/compiler';
 
@@ -831,17 +831,28 @@ class R3TestBedCompiler {
         this.queueTypesFromModulesArray([ngModule]);
     }
     overrideComponent(component, override) {
+        this.verifyNoStandaloneFlagOverrides(component, override);
         this.resolvers.component.addOverride(component, override);
         this.pendingComponents.add(component);
     }
     overrideDirective(directive, override) {
+        this.verifyNoStandaloneFlagOverrides(directive, override);
         this.resolvers.directive.addOverride(directive, override);
         this.pendingDirectives.add(directive);
     }
     overridePipe(pipe, override) {
+        this.verifyNoStandaloneFlagOverrides(pipe, override);
         this.resolvers.pipe.addOverride(pipe, override);
         this.pendingPipes.add(pipe);
     }
+    verifyNoStandaloneFlagOverrides(type, override) {
+        var _a, _b, _c;
+        if (((_a = override.add) === null || _a === void 0 ? void 0 : _a.hasOwnProperty('standalone')) || ((_b = override.set) === null || _b === void 0 ? void 0 : _b.hasOwnProperty('standalone')) ||
+            ((_c = override.remove) === null || _c === void 0 ? void 0 : _c.hasOwnProperty('standalone'))) {
+            throw new Error(`An override for the ${type.name} class has the \`standalone\` flag. ` +
+                `Changing the \`standalone\` flag via TestBed overrides is not supported.`);
+        }
+    }
     overrideProvider(token, provider) {
         let providerDef;
         if (provider.useFactory !== undefined) {
@@ -1060,12 +1071,29 @@ class R3TestBedCompiler {
         this.seenDirectives.clear();
     }
     applyProviderOverridesToModule(moduleType) {
+        var _a;
         if (this.moduleProvidersOverridden.has(moduleType)) {
             return;
         }
         this.moduleProvidersOverridden.add(moduleType);
+        // NOTE: the line below triggers JIT compilation of the module injector,
+        // which also invokes verification of the NgModule semantics, which produces
+        // detailed error messages. The fact that the code relies on this line being
+        // present here is suspicious and should be refactored in a way that the line
+        // below can be moved (for ex. after an early exit check below).
         const injectorDef = moduleType[ɵNG_INJ_DEF];
-        if (this.providerOverridesByToken.size > 0) {
+        // No provider overrides, exit early.
+        if (this.providerOverridesByToken.size === 0)
+            return;
+        if (isStandaloneComponent(moduleType)) {
+            // Visit all component dependencies and override providers there.
+            const def = getComponentDef(moduleType);
+            const dependencies = maybeUnwrapFn((_a = def.dependencies) !== null && _a !== void 0 ? _a : []);
+            for (const dependency of dependencies) {
+                this.applyProviderOverridesToModule(dependency);
+            }
+        }
+        else {
             const providers = [
                 ...injectorDef.providers,
                 ...(this.providerOverridesByModule.get(moduleType) || [])
@@ -1140,8 +1168,11 @@ class R3TestBedCompiler {
             // real module, which was imported. This pattern is understood to mean that the component
             // should use its original scope, but that the testing module should also contain the
             // component in its scope.
-            if (!this.componentToModuleScope.has(type) ||
-                this.componentToModuleScope.get(type) === TestingModuleOverride.DECLARATION) {
+            //
+            // Note: standalone components have no associated NgModule, so the `moduleType` can be `null`.
+            if (moduleType !== null &&
+                (!this.componentToModuleScope.has(type) ||
+                    this.componentToModuleScope.get(type) === TestingModuleOverride.DECLARATION)) {
                 this.componentToModuleScope.set(type, moduleType);
             }
             return;
@@ -1166,6 +1197,7 @@ class R3TestBedCompiler {
         // encountered. In some test setups, this caching resulted in 10X runtime improvement.
         const processedNgModuleDefs = new Set();
         const queueTypesFromModulesArrayRecur = (arr) => {
+            var _a;
             for (const value of arr) {
                 if (Array.isArray(value)) {
                     queueTypesFromModulesArrayRecur(value);
@@ -1185,6 +1217,11 @@ class R3TestBedCompiler {
                 else if (isModuleWithProviders(value)) {
                     queueTypesFromModulesArrayRecur([value.ngModule]);
                 }
+                else if (isStandaloneComponent(value)) {
+                    this.queueType(value, null);
+                    const def = getComponentDef(value);
+                    queueTypesFromModulesArrayRecur(maybeUnwrapFn((_a = def.dependencies) !== null && _a !== void 0 ? _a : []));
+                }
             }
         };
         queueTypesFromModulesArrayRecur(arr);
@@ -1402,6 +1439,14 @@ function initResolvers() {
         pipe: new PipeResolver()
     };
 }
+function isStandaloneComponent(value) {
+    const def = getComponentDef(value);
+    return !!(def === null || def === void 0 ? void 0 : def.standalone);
+}
+function getComponentDef(value) {
+    var _a;
+    return (_a = value.ɵcmp) !== null && _a !== void 0 ? _a : null;
+}
 function hasNgModuleDef(value) {
     return value.hasOwnProperty('ɵmod');
 }
@@ -1480,6 +1525,10 @@ class R3TestCompiler {
  */
 /** 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.
  *
@@ -1539,9 +1588,9 @@ class TestBedRender3 {
      *
      * @publicApi
      */
-    static initTestEnvironment(ngModule, platform, summariesOrOptions) {
+    static initTestEnvironment(ngModule, platform, options) {
         const testBed = _getTestBedRender3();
-        testBed.initTestEnvironment(ngModule, platform, summariesOrOptions);
+        testBed.initTestEnvironment(ngModule, platform, options);
         return testBed;
     }
     /**
@@ -1639,14 +1688,13 @@ class TestBedRender3 {
      *
      * @publicApi
      */
-    initTestEnvironment(ngModule, platform, summariesOrOptions) {
+    initTestEnvironment(ngModule, platform, options) {
         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;
+        TestBedRender3._environmentTeardownOptions = options === null || options === void 0 ? void 0 : options.teardown;
+        TestBedRender3._environmentErrorOnUnknownElementsOption = options === null || options === void 0 ? void 0 : options.errorOnUnknownElements;
+        TestBedRender3._environmentErrorOnUnknownPropertiesOption = options === null || options === void 0 ? void 0 : options.errorOnUnknownProperties;
         this.platform = platform;
         this.ngModule = ngModule;
         this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
@@ -1670,12 +1718,17 @@ class TestBedRender3 {
         ɵsetAllowDuplicateNgModuleIdsForTest(false);
     }
     resetTestingModule() {
+        var _a, _b;
         this.checkGlobalCompilationFinished();
         ɵresetCompiledComponents();
         if (this._compiler !== null) {
             this.compiler.restoreOriginalState();
         }
         this._compiler = new R3TestBedCompiler(this.platform, this.ngModule);
+        // Restore the previous value of the "error on unknown elements" option
+        ɵsetUnknownElementStrictMode((_a = this._previousErrorOnUnknownElementsOption) !== null && _a !== void 0 ? _a : THROW_ON_UNKNOWN_ELEMENTS_DEFAULT);
+        // Restore the previous value of the "error on unknown properties" option
+        ɵsetUnknownPropertyStrictMode((_b = this._previousErrorOnUnknownPropertiesOption) !== null && _b !== void 0 ? _b : THROW_ON_UNKNOWN_PROPERTIES_DEFAULT);
         // 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.
@@ -1691,6 +1744,8 @@ class TestBedRender3 {
             finally {
                 this._testModuleRef = null;
                 this._instanceTeardownOptions = undefined;
+                this._instanceErrorOnUnknownElementsOption = undefined;
+                this._instanceErrorOnUnknownPropertiesOption = undefined;
             }
         }
     }
@@ -1709,9 +1764,17 @@ class TestBedRender3 {
         // their components scoped properly. See the `checkGlobalCompilationFinished` function
         // description for additional info.
         this.checkGlobalCompilationFinished();
-        // Always re-assign the teardown options, even if they're undefined.
-        // This ensures that we don't carry the options between tests.
+        // Always re-assign the options, even if they're undefined.
+        // This ensures that we don't carry them between tests.
         this._instanceTeardownOptions = moduleDef.teardown;
+        this._instanceErrorOnUnknownElementsOption = moduleDef.errorOnUnknownElements;
+        this._instanceErrorOnUnknownPropertiesOption = moduleDef.errorOnUnknownProperties;
+        // Store the current value of the strict mode option,
+        // so we can restore it later
+        this._previousErrorOnUnknownElementsOption = ɵgetUnknownElementStrictMode();
+        ɵsetUnknownElementStrictMode(this.shouldThrowErrorOnUnknownElements());
+        this._previousErrorOnUnknownPropertiesOption = ɵgetUnknownPropertyStrictMode();
+        ɵsetUnknownPropertyStrictMode(this.shouldThrowErrorOnUnknownProperties());
         this.compiler.configureTestingModule(moduleDef);
     }
     compileComponents() {
@@ -1767,7 +1830,7 @@ class TestBedRender3 {
         testComponentRenderer.insertRootElement(rootElId);
         const componentDef = type.ɵcmp;
         if (!componentDef) {
-            throw new Error(`It looks like '${ɵstringify(type)}' has not been IVY compiled - it has no 'ɵcmp' field`);
+            throw new Error(`It looks like '${ɵstringify(type)}' has not been compiled.`);
         }
         // TODO: Don't cast as `InjectionToken<boolean>`, proper type is boolean[]
         const noNgZone = this.inject(ComponentFixtureNoNgZone, false);
@@ -1860,6 +1923,16 @@ class TestBedRender3 {
         // 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 : this.shouldTearDownTestingModule();
     }
+    shouldThrowErrorOnUnknownElements() {
+        var _a, _b;
+        // Check if a configuration has been provided to throw when an unknown element is found
+        return (_b = (_a = this._instanceErrorOnUnknownElementsOption) !== null && _a !== void 0 ? _a : TestBedRender3._environmentErrorOnUnknownElementsOption) !== null && _b !== void 0 ? _b : THROW_ON_UNKNOWN_ELEMENTS_DEFAULT;
+    }
+    shouldThrowErrorOnUnknownProperties() {
+        var _a, _b;
+        // Check if a configuration has been provided to throw when an unknown property is found
+        return (_b = (_a = this._instanceErrorOnUnknownPropertiesOption) !== null && _a !== void 0 ? _a : TestBedRender3._environmentErrorOnUnknownPropertiesOption) !== null && _b !== void 0 ? _b : THROW_ON_UNKNOWN_PROPERTIES_DEFAULT;
+    }
     shouldTearDownTestingModule() {
         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;