@wordpress/jest-preset-default

Default Jest preset for WordPress development.

Installation

Install the module

npm install @wordpress/jest-preset-default --save-dev

Note: This package requires Node.js 14.0.0 or later. It is not compatible with older versions.

Setup

Via jest.config.json or jest field in package.json

{
    "preset": "@wordpress/jest-preset-default"
}

Usage

Brief explanations of options included

  • moduleNameMapper – all css and scss files containing CSS styles will be stubbed out.
  • modulePaths – the root dir of the project is used as a location to search when resolving modules.
  • setupFiles – runs code before each test which sets up global variables required in the testing environment.
  • setupFilesAfterEnv – runs code which adds improved support for Console object and React components to the testing framework before each test.
  • testEnvironment – enabled the jsdom environment for all tests by default.
  • testMatch – searches for tests in /test/ and /__tests__/ subfolders, and also matches all files with a .test.* suffix. It detects test files with a .js, .jsx, .ts or .tsx suffix. Compared to default Jest configuration, it doesn’t match files with the .spec.* suffix.
  • testPathIgnorePatterns – excludes node_modules and vendor directories from searching for test files.
  • transform – keeps the default babel-jest transformer.

Using enzyme

Historically, this package used to use enzyme, but support was dropped in favor of @testing-library/react, primary reason being unblocking the upgrade to React 18.

If you wish to use enzyme, you can still use it by manually providing the React 17 adapter, by following the steps below.

To install the enzyme dependency, run:

npm install --save enzyme

To install the React 17 adapter dependency, run:

npm install --save @wojtekmaj/enzyme-adapter-react-17

To use the React 17 adapter, use this in your setupFilesAfterEnv configuration:

// It "mocks" enzyme, so that we can delay loading of
// the utility functions until enzyme is imported in tests.
// Props to @gdborton for sharing this technique in his article:
// https://medium.com/airbnb-engineering/unlocking-test-performance-migrating-from-mocha-to-jest-2796c508ec50.
let mockEnzymeSetup = false;

jest.mock( 'enzyme', () => {
    const actualEnzyme = jest.requireActual( 'enzyme' );
    if ( ! mockEnzymeSetup ) {
        mockEnzymeSetup = true;

        // Configure enzyme 3 for React, from docs: http://airbnb.io/enzyme/docs/installation/index.html
        const Adapter = jest.requireActual(
            '@wojtekmaj/enzyme-adapter-react-17'
        );
        actualEnzyme.configure( { adapter: new Adapter() } );
    }
    return actualEnzyme;
} );

If you also use snapshot tests with enzyme, you might want to add support for serializing them, through the enzyme-to-json package.

To install the dependency, run:

npm install --save enzyme-to-json

Finally, you should add enzyme-to-json/serializer to the array of snapshotSerializers:

{
    snapshotSerializers: [ 'enzyme-to-json/serializer' ]
}

Contributing to this package

This is an individual package that’s part of the Gutenberg project. The project is organized as a monorepo. It’s made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project’s main contributor guide.