feat(core): TestBed.getFixture -> TestBed.getLastFixture and update implementation

atscott · mattrbeck · commit dc3131c63954 · 2026-03-12T14:57:16.000-06:00
TestBed.getFixture is now TestBed.getLastFixture and returns the last fixture
created rather than throwing if there are more than 1.
diff --git a/goldens/public-api/core/testing/index.api.md b/goldens/public-api/core/testing/index.api.md
@@ -120,7 +120,7 @@ export interface TestBed {
     execute(tokens: any[], fn: Function, context?: any): any;
     // @deprecated
     flushEffects(): void;
-    getFixture<T = unknown>(): ComponentFixture<T>;
+    getLastFixture<T = unknown>(): ComponentFixture<T>;
     initTestEnvironment(ngModule: Type<any> | Type<any>[], platform: PlatformRef, options?: TestEnvironmentOptions): void;
     // (undocumented)
     inject<T>(token: ProviderToken<T>, notFoundValue: undefined, options: InjectOptions & {
diff --git a/packages/core/testing/src/test_bed.ts b/packages/core/testing/src/test_bed.ts
@@ -175,7 +175,7 @@ export interface TestBed {
    * Returns the most recently created `ComponentFixture`, or throws an error if one has not
    * yet been created.
    */
-  getFixture<T = unknown>(): ComponentFixture<T>;
+  getLastFixture<T = unknown>(): ComponentFixture<T>;
 
   /**
    * Execute any pending effects.
@@ -420,8 +420,8 @@ export class TestBedImpl implements TestBed {
     return TestBedImpl.INSTANCE.createComponent(component, options);
   }
 
-  static getFixture<T = unknown>(): ComponentFixture<T> {
-    return TestBedImpl.INSTANCE.getFixture();
+  static getLastFixture<T = unknown>(): ComponentFixture<T> {
+    return TestBedImpl.INSTANCE.getLastFixture();
   }
 
   static resetTestingModule(): TestBed {
@@ -719,17 +719,11 @@ export class TestBedImpl implements TestBed {
     return fixture;
   }
 
-  getFixture<T = unknown>(): ComponentFixture<T> {
+  getLastFixture<T = unknown>(): ComponentFixture<T> {
     if (this._activeFixtures.length === 0) {
       throw new Error('No fixture has been created yet.');
     }
-    if (this._activeFixtures.length > 1) {
-      throw new Error(
-        `More than one component fixture has been created. Use \`TestBed.createComponent\` ` +
-          `and store the fixture on the test context, rather than using \`TestBed.getFixture\`.`,
-      );
-    }
-    return this._activeFixtures[0];
+    return this._activeFixtures[this._activeFixtures.length - 1];
   }
 
   /**
diff --git a/packages/platform-browser/test/testing_public_spec.ts b/packages/platform-browser/test/testing_public_spec.ts
@@ -1104,29 +1104,26 @@ Did you run and wait for 'resolveComponentResources()'?`);
       expect(componentFixture.nativeElement).toHaveText('injected value: mocked out value');
     }));
 
-    describe('getFixture', () => {
+    describe('getLastFixture', () => {
       it('should return the last created fixture', () => {
         const fixture = TestBed.createComponent(ChildComp);
-        expect(TestBed.getFixture()).toBe(fixture);
+        expect(TestBed.getLastFixture()).toBe(fixture);
       });
 
       it('should throw if no fixture has been created', () => {
-        expect(() => TestBed.getFixture()).toThrowError('No fixture has been created yet.');
+        expect(() => TestBed.getLastFixture()).toThrowError('No fixture has been created yet.');
       });
 
-      it('should throw an error if multiple fixtures are present', () => {
+      it('should return the last fixture when multiple fixtures are present', () => {
         TestBed.createComponent(ChildComp);
-        TestBed.createComponent(ParentComp);
-        expect(() => TestBed.getFixture()).toThrowError(
-          `More than one component fixture has been created. Use \`TestBed.createComponent\` ` +
-            `and store the fixture on the test context, rather than using \`TestBed.getFixture\`.`,
-        );
+        const parentFixture = TestBed.createComponent(ParentComp);
+        expect(TestBed.getLastFixture()).toBe(parentFixture);
       });
 
       it('should clear the fixture after reset', () => {
         TestBed.createComponent(ChildComp);
         TestBed.resetTestingModule();
-        expect(() => TestBed.getFixture()).toThrowError('No fixture has been created yet.');
+        expect(() => TestBed.getLastFixture()).toThrowError('No fixture has been created yet.');
       });
     });
   });
diff --git a/packages/private/testing/src/utils.ts b/packages/private/testing/src/utils.ts
@@ -245,7 +245,7 @@ export async function expectText(
   text: string | RegExp,
   options: ExpectTextOptions = {},
 ): Promise<void> {
-  const container = options.container || TestBed.getFixture().nativeElement;
+  const container = options.container || TestBed.getLastFixture().nativeElement;
   await waitFor(() => {
     const content = container.textContent || '';
     if (typeof text === 'string') {
