@angular/core 20.0.0-rc.0 → 20.0.0-rc.2

package/fesm2022/testing.mjs

@@ -1,13 +1,13 @@
 /**
- * @license Angular v20.0.0-rc.0
+ * @license Angular v20.0.0-rc.2
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 
-import { CONTAINER_HEADER_OFFSET, InjectionToken, inject as inject$1, EnvironmentInjector, ErrorHandler, PendingTasksInternal, ZONELESS_ENABLED, ChangeDetectionScheduler, EffectScheduler, stringify, getInjectableDef, resolveForwardRef, NG_COMP_DEF, NG_DIR_DEF, NG_PIPE_DEF, NG_INJ_DEF, NG_MOD_DEF, ENVIRONMENT_INITIALIZER, INTERNAL_APPLICATION_ERROR_HANDLER, Injector, isEnvironmentProviders, runInInjectionContext } from './root_effect_scheduler-B_EWGyLU.mjs';
 import { Subscription } from 'rxjs';
-import { DeferBlockState, triggerResourceLoading, renderDeferBlockState, getDeferBlocks, DeferBlockBehavior, NgZone, Injectable, NoopNgZone, ApplicationRef, getDebugNode, RendererFactory2, Pipe, Directive, Component, NgModule, ReflectionCapabilities, depsTracker, isComponentDefPendingResolution, getAsyncClassMetadataFn, resolveComponentResources, NgModuleRef, ApplicationInitStatus, LOCALE_ID, DEFAULT_LOCALE_ID, setLocaleId, ComponentFactory, compileComponent, compileDirective, compilePipe, patchComponentDefWithScope, compileNgModuleDefs, clearResolutionOfComponentResourcesQueue, restoreComponentResolutionQueue, internalProvideZoneChangeDetection, ChangeDetectionSchedulerImpl, Compiler, DEFER_BLOCK_CONFIG, COMPILER_OPTIONS, transitiveScopesFor, generateStandaloneInDeclarationsError, NgModuleFactory, ModuleWithComponentFactories, resetCompiledComponents, ɵsetUnknownElementStrictMode as _setUnknownElementStrictMode, ɵsetUnknownPropertyStrictMode as _setUnknownPropertyStrictMode, ɵgetUnknownElementStrictMode as _getUnknownElementStrictMode, ɵgetUnknownPropertyStrictMode as _getUnknownPropertyStrictMode, flushModuleScopingQueueAsMuchAsPossible, setAllowDuplicateNgModuleIdsForTest } from './debug_node-3mmnD06K.mjs';
+import { inject as inject$1, EnvironmentInjector, ErrorHandler, CONTAINER_HEADER_OFFSET, InjectionToken, PendingTasksInternal, ZONELESS_ENABLED, ChangeDetectionScheduler, EffectScheduler, stringify, getInjectableDef, resolveForwardRef, NG_COMP_DEF, NG_DIR_DEF, NG_PIPE_DEF, NG_INJ_DEF, NG_MOD_DEF, ENVIRONMENT_INITIALIZER, INTERNAL_APPLICATION_ERROR_HANDLER, Injector, isEnvironmentProviders, runInInjectionContext } from './root_effect_scheduler-BgGHQ80j.mjs';
 import * as i0 from '@angular/core';
+import { NgZone, Injectable, DeferBlockState, triggerResourceLoading, renderDeferBlockState, getDeferBlocks, DeferBlockBehavior, NoopNgZone, ApplicationRef, getDebugNode, RendererFactory2, Pipe, Directive, Component, NgModule, ReflectionCapabilities, depsTracker, isComponentDefPendingResolution, getAsyncClassMetadataFn, resolveComponentResources, NgModuleRef, ApplicationInitStatus, LOCALE_ID, DEFAULT_LOCALE_ID, setLocaleId, ComponentFactory, compileComponent, compileDirective, compilePipe, patchComponentDefWithScope, compileNgModuleDefs, clearResolutionOfComponentResourcesQueue, restoreComponentResolutionQueue, internalProvideZoneChangeDetection, ChangeDetectionSchedulerImpl, Compiler, DEFER_BLOCK_CONFIG, COMPILER_OPTIONS, transitiveScopesFor, generateStandaloneInDeclarationsError, NgModuleFactory, ModuleWithComponentFactories, resetCompiledComponents, ɵsetUnknownElementStrictMode as _setUnknownElementStrictMode, ɵsetUnknownPropertyStrictMode as _setUnknownPropertyStrictMode, ɵgetUnknownElementStrictMode as _getUnknownElementStrictMode, ɵgetUnknownPropertyStrictMode as _getUnknownPropertyStrictMode, flushModuleScopingQueueAsMuchAsPossible, setAllowDuplicateNgModuleIdsForTest } from './debug_node-Nc-zr65s.mjs';
 import { ResourceLoader } from '@angular/compiler';
 import './primitives/di.mjs';
 import './signal-ePSl6jXn.mjs';
@@ -51,6 +51,42 @@ function waitForAsync(fn) {
     };
 }
 
+const RETHROW_APPLICATION_ERRORS_DEFAULT = true;
+class TestBedApplicationErrorHandler {
+    zone = inject$1(NgZone);
+    injector = inject$1(EnvironmentInjector);
+    userErrorHandler;
+    whenStableRejectFunctions = new Set();
+    handleError(e) {
+        try {
+            this.zone.runOutsideAngular(() => {
+                this.userErrorHandler ??= this.injector.get(ErrorHandler);
+                this.userErrorHandler.handleError(e);
+            });
+        }
+        catch (userError) {
+            e = userError;
+        }
+        // Instead of throwing the error when there are outstanding `fixture.whenStable` promises,
+        // reject those promises with the error. This allows developers to write
+        // expectAsync(fix.whenStable()).toBeRejected();
+        if (this.whenStableRejectFunctions.size > 0) {
+            for (const fn of this.whenStableRejectFunctions.values()) {
+                fn(e);
+            }
+            this.whenStableRejectFunctions.clear();
+        }
+        else {
+            throw e;
+        }
+    }
+    static ɵfac = function TestBedApplicationErrorHandler_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || TestBedApplicationErrorHandler)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: TestBedApplicationErrorHandler, factory: TestBedApplicationErrorHandler.ɵfac });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(TestBedApplicationErrorHandler, [{
+        type: Injectable
+    }], null, null); })();
+
 /**
  * Represents an individual defer block for testing purposes.
  *
@@ -59,7 +95,7 @@ function waitForAsync(fn) {
 class DeferBlockFixture {
     block;
     componentFixture;
-    /** @nodoc */
+    /** @docs-private */
     constructor(block, componentFixture) {
         this.block = block;
         this.componentFixture = componentFixture;
@@ -156,42 +192,6 @@ const ComponentFixtureAutoDetect = new InjectionToken('ComponentFixtureAutoDetec
  */
 const ComponentFixtureNoNgZone = new InjectionToken('ComponentFixtureNoNgZone');
 
-const RETHROW_APPLICATION_ERRORS_DEFAULT = true;
-class TestBedApplicationErrorHandler {
-    zone = inject$1(NgZone);
-    injector = inject$1(EnvironmentInjector);
-    userErrorHandler;
-    whenStableRejectFunctions = new Set();
-    handleError(e) {
-        try {
-            this.zone.runOutsideAngular(() => {
-                this.userErrorHandler ??= this.injector.get(ErrorHandler);
-                this.userErrorHandler.handleError(e);
-            });
-        }
-        catch (userError) {
-            e = userError;
-        }
-        // Instead of throwing the error when there are outstanding `fixture.whenStable` promises,
-        // reject those promises with the error. This allows developers to write
-        // expectAsync(fix.whenStable()).toBeRejected();
-        if (this.whenStableRejectFunctions.size > 0) {
-            for (const fn of this.whenStableRejectFunctions.values()) {
-                fn(e);
-            }
-            this.whenStableRejectFunctions.clear();
-        }
-        else {
-            throw e;
-        }
-    }
-    static ɵfac = function TestBedApplicationErrorHandler_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || TestBedApplicationErrorHandler)(); };
-    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: TestBedApplicationErrorHandler, factory: TestBedApplicationErrorHandler.ɵfac });
-}
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(TestBedApplicationErrorHandler, [{
-        type: Injectable
-    }], null, null); })();
-
 /**
  * Fixture for debugging and testing a component.
  *
@@ -244,7 +244,7 @@ class ComponentFixture {
     subscriptions = new Subscription();
     // TODO(atscott): Remove this from public API
     ngZone = this._noZoneOptionIsSet ? null : this._ngZone;
-    /** @nodoc */
+    /** @docs-private */
     constructor(componentRef) {
         this.componentRef = componentRef;
         this.changeDetectorRef = componentRef.changeDetectorRef;
@@ -253,13 +253,15 @@ class ComponentFixture {
         this.componentInstance = componentRef.instance;
         this.nativeElement = this.elementRef.nativeElement;
         this.componentRef = componentRef;
+        this._testAppRef.allTestViews.add(this.componentRef.hostView);
         if (this.autoDetect) {
-            this._testAppRef.externalTestViews.add(this.componentRef.hostView);
+            this._testAppRef.autoDetectTestViews.add(this.componentRef.hostView);
             this.scheduler?.notify(8 /* ɵNotificationSource.ViewAttached */);
             this.scheduler?.notify(0 /* ɵNotificationSource.MarkAncestorsForTraversal */);
         }
         this.componentRef.hostView.onDestroy(() => {
-            this._testAppRef.externalTestViews.delete(this.componentRef.hostView);
+            this._testAppRef.allTestViews.delete(this.componentRef.hostView);
+            this._testAppRef.autoDetectTestViews.delete(this.componentRef.hostView);
         });
         // Create subscriptions outside the NgZone so that the callbacks run outside
         // of NgZone.
@@ -293,13 +295,11 @@ class ComponentFixture {
             }
             if (this.zonelessEnabled) {
                 try {
-                    this._testAppRef.externalTestViews.add(this.componentRef.hostView);
+                    this._testAppRef.includeAllTestViews = true;
                     this._appRef.tick();
                 }
                 finally {
-                    if (!this.autoDetect) {
-                        this._testAppRef.externalTestViews.delete(this.componentRef.hostView);
-                    }
+                    this._testAppRef.includeAllTestViews = false;
                 }
             }
             else {
@@ -323,24 +323,18 @@ class ComponentFixture {
     checkNoChanges() {
         this.changeDetectorRef.checkNoChanges();
     }
-    /**
-     * Set whether the fixture should autodetect changes.
-     *
-     * Also runs detectChanges once so that any existing change is detected.
-     *
-     * @param autoDetect Whether to autodetect changes. By default, `true`.
-     */
     autoDetectChanges(autoDetect = true) {
+        if (!autoDetect && this.zonelessEnabled) {
+            throw new Error('Cannot set autoDetect to false with zoneless change detection.');
+        }
         if (this._noZoneOptionIsSet && !this.zonelessEnabled) {
             throw new Error('Cannot call autoDetectChanges when ComponentFixtureNoNgZone is set.');
         }
-        if (autoDetect !== this.autoDetect) {
-            if (autoDetect) {
-                this._testAppRef.externalTestViews.add(this.componentRef.hostView);
-            }
-            else {
-                this._testAppRef.externalTestViews.delete(this.componentRef.hostView);
-            }
+        if (autoDetect) {
+            this._testAppRef.autoDetectTestViews.add(this.componentRef.hostView);
+        }
+        else {
+            this._testAppRef.autoDetectTestViews.delete(this.componentRef.hostView);
         }
         this.autoDetect = autoDetect;
         this.detectChanges();
@@ -404,7 +398,8 @@ class ComponentFixture {
      */
     destroy() {
         this.subscriptions.unsubscribe();
-        this._testAppRef.externalTestViews.delete(this.componentRef.hostView);
+        this._testAppRef.autoDetectTestViews.delete(this.componentRef.hostView);
+        this._testAppRef.allTestViews.delete(this.componentRef.hostView);
         if (!this._isDestroyed) {
             this.componentRef.destroy();
             this._isDestroyed = true;
@@ -429,7 +424,7 @@ function resetFakeAsyncZone() {
     throw new Error(fakeAsyncTestModuleNotLoadedErrorMessage);
 }
 function resetFakeAsyncZoneIfExists() {
-    if (fakeAsyncTestModule) {
+    if (fakeAsyncTestModule && Zone['ProxyZoneSpec']?.isLoaded()) {
         fakeAsyncTestModule.resetFakeAsyncZone();
     }
 }
@@ -879,9 +874,7 @@ class TestBedCompiler {
             moduleDef.rethrowApplicationErrors ?? RETHROW_APPLICATION_ERRORS_DEFAULT;
     }
     overrideModule(ngModule, override) {
-        {
-            depsTracker.clearScopeCacheFor(ngModule);
-        }
+        depsTracker.clearScopeCacheFor(ngModule);
         this.overriddenModules.add(ngModule);
         // Compile the module right away.
         this.resolvers.module.addOverride(ngModule, override);
@@ -1097,9 +1090,7 @@ class TestBedCompiler {
                 throw invalidTypeError(declaration.name, 'Component');
             }
             this.maybeStoreNgDef(NG_COMP_DEF, declaration);
-            {
-                depsTracker.clearScopeCacheFor(declaration);
-            }
+            depsTracker.clearScopeCacheFor(declaration);
             compileComponent(declaration, metadata);
         });
         this.pendingComponents.clear();
@@ -1132,9 +1123,7 @@ class TestBedCompiler {
             const affectedModules = this.collectModulesAffectedByOverrides(testingModuleDef.imports);
             if (affectedModules.size > 0) {
                 affectedModules.forEach((moduleType) => {
-                    {
-                        depsTracker.clearScopeCacheFor(moduleType);
-                    }
+                    depsTracker.clearScopeCacheFor(moduleType);
                 });
             }
         }
@@ -1455,9 +1444,7 @@ class TestBedCompiler {
         });
         // Restore initial component/directive/pipe defs
         this.initialNgDefs.forEach((defs, type) => {
-            {
-                depsTracker.clearScopeCacheFor(type);
-            }
+            depsTracker.clearScopeCacheFor(type);
             defs.forEach((descriptor, prop) => {
                 if (!descriptor) {
                     // Delete operations are generally undesirable since they have performance
@@ -1872,6 +1859,9 @@ class TestBedImpl {
     static get ngModule() {
         return TestBedImpl.INSTANCE.ngModule;
     }
+    static flushEffects() {
+        return TestBedImpl.INSTANCE.tick();
+    }
     static tick() {
         return TestBedImpl.INSTANCE.tick();
     }
@@ -1884,7 +1874,7 @@ class TestBedImpl {
     /**
      * Internal-only flag to indicate whether a module
      * scoping queue has been checked and flushed already.
-     * @nodoc
+     * @docs-private
      */
     globalCompilationChecked = false;
     /**
@@ -2196,13 +2186,32 @@ class TestBedImpl {
             testRenderer.removeAllRootElements?.();
         }
     }
+    /**
+     * Execute any pending effects by executing any pending work required to synchronize model to the UI.
+     *
+     * @deprecated use `TestBed.tick()` instead
+     */
+    flushEffects() {
+        this.tick();
+    }
     /**
      * Execute any pending work required to synchronize model to the UI.
      *
      * @publicApi
      */
     tick() {
-        this.inject(ApplicationRef).tick();
+        const appRef = this.inject(ApplicationRef);
+        try {
+            // TODO(atscott): ApplicationRef.tick should set includeAllTestViews to true itself rather than doing this here and in ComponentFixture
+            // The behavior should be that TestBed.tick, ComponentFixture.detectChanges, and ApplicationRef.tick all result in the test fixtures
+            // getting synchronized, regardless of whether they are autoDetect: true.
+            // Automatic scheduling (zone or zoneless) will call _tick which will _not_ include fixtures with autoDetect: false
+            appRef.includeAllTestViews = true;
+            appRef.tick();
+        }
+        finally {
+            appRef.includeAllTestViews = false;
+        }
     }
 }
 /**