Jest preset configuration for Angular projects

Package: jest-preset-angular

Created by: thymikee

Last modified: Fri, 16 Feb 2024 09:02:33 GMT

Version: 14.0.3

License: MIT

Downloads: 2,839,089

Repository: https://github.com/thymikee/jest-preset-angular

Install

npm install jest-preset-angular

yarn add jest-preset-angular

Jest Preset Angular

A preset of Jest configuration for Angular projects.

Our online documentation is available at https://thymikee.github.io/jest-preset-angular/

This is a part of the article: Testing Angular faster with Jest.

Getting Started

These instructions will get you setup to use jest-preset-angular in your project. For more detailed documentation,
please check online documentation.

Install using yarn:

 yarn add -D jest jest-preset-angular @types/jest

Or npm:

 npm install -D jest jest-preset-angular @types/jest

Configuration

In your project root, create setup-jest.ts file with following contents:

 import 'jest-preset-angular/setup-jest';

Add the following section:

to your root jest.config.js

 // jest.config.js
module.exports = {
  preset: 'jest-preset-angular',
  setupFilesAfterEnv: ['<rootDir>/setup-jest.ts'],
  globalSetup: 'jest-preset-angular/global-setup',
};

or to your root package.json

 {
  "jest": {
    "preset": "jest-preset-angular",
    "setupFilesAfterEnv": ["<rootDir>/setup-jest.ts"],
    "globalSetup": "jest-preset-angular/global-setup"
  }
}

Adjust your tsconfig.spec.json to be:

 {
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "outDir": "./out-tsc/spec",
    "module": "CommonJs",
    "types": ["jest"]
  },
  "include": ["src/**/*.spec.ts", "src/**/*.d.ts"]
}

IMPORTANT

Angular doesn't support native async/await in testing with target higher than ES2016, see https://github.com/angular/components/issues/21632#issuecomment-764975917

Migration from Angular < 13

Check out our Migration from Angular < 13 guidance

Angular Ivy

Check out our Angular Ivy guidance

Example projects with base Jest configuration

We have example apps to provide a basic setup to use Jest in an Angular project.
The examples folder consist of several example Angular applications from v13 onwards as well as example projects
with yarn workspace or monorepo structure.