Simplifying Angular testbed setup by converting to synchronous test hooks

October 30, 2021

Last updated: November 1, 2021

254 words

Post contents

When we use Angular's schematics to generate components, unnecessary asynchronous code is added to the test setup hook for its test suite.

The following test setup is generated by Angular's component generation schematic:

beforeEach(async () => {  await TestBed.configureTestingModule({    declarations: [MyComponent],  }).compileComponents();});
Angular testbed setup generated by the component schematic.

Alternatively, we might be using Angular's waitForAsync test function wrapper (formerly named async) as seen in the following code snippet:

beforeEach(waitForAsync(() => {  TestBed.configureTestingModule({    declarations: [MyComponent],  }).compileComponents();}));
Angular testbed setup using waitForAsync.

Here's the deal: It's only necessary to call the static TestBed.compileComponents method if we're not using the Angular CLI to run our tests (who would do such a thing, Google? 👈😏).

The Angular CLI compiles our application and tests before the tests are run so no asynchronous action is needed for setting up the declarables.

Let's simplify the common test setup by leaving out async-await, waitForAsync, and even the TestBed.compileComponents invocation as seen in this code snippet:

beforeEach(() => {  TestBed.configureTestingModule({    declarations: [MyComponent],  });});
Simplified Angular testbed setup.

The following points are true for common Angular testbed setup for tests covering all types of Angular declarables:

  • No need to use async-await
  • No need to use waitForAsync (formerly named async)
  • No need to call TestBed.compileComponents

Of course, there might be other reasons for introducing asynchronicity to our test setup but compiling and linking declarables is not one of them.

Enjoy a little less boilerplate in your Angular tests 🌞

Subscribe to our newsletter!

Subscribe to our newsletter to get updates on new content we create, events we have coming up, and more! We'll make sure not to spam you and provide good insights to the content we have.