300

I'm running Jest tests via npm test. Jest runs tests in parallel by default. Is there any way to make the tests run sequentially?

I have some tests calling third-party code that relies on changing the current working directory.

13 Answers 13

391

CLI options are documented and also accessible by running the command jest --help.

You'll see the option you are looking for : --runInBand.

17
  • 13
    Thanks a lot! Is it npm test --runInBand? Offtopic: Not sure where the name "band" comes from. --runSequentially would probably make more sense :) Jan 21, 2017 at 5:33
  • 24
    @MartinKonicek npm test -- --runInBand is correct. Feb 22, 2017 at 15:49
  • 78
    Unfortunately, the fact that execution order can't be controlled makes Jest pretty much useless for integration tests.
    – Evan Byrne
    Jul 6, 2018 at 18:43
  • 54
    @Evan The fact you need your tests run in a certain order is a smell. Jun 3, 2019 at 18:25
  • 77
    @NicoVanBelle It's simply the price you pay for true end-to-end testing of sufficiently complex stateful systems. I'm open to alternatives, but I have yet to see a solution that doesn't either involve naively swapping out key parts of the stack or prohibitively slow database resets between tests. Doesn't mean Jest is a bad tool, just the wrong one for this particular kind of test.
    – Evan Byrne
    Jun 4, 2019 at 17:56
73

I'm still getting familiar with Jest, but it appears that describe blocks run synchronously whereas test blocks run asynchronously. I'm running multiple describe blocks within an outer describe that looks something like this:

describe
    describe
        test1
        test2

    describe
        test3

In this case, test3 does not run until test2 is complete because test3 is in a describe block that follows the describe block that contains test2.

7
  • 10
    Maybe it will still run in parallel.
    – LCB
    Jan 21, 2019 at 3:32
  • This is great. Makes it possible to first check behavior with missing environment variables, then set the variables and do further tests. May 1, 2019 at 7:41
  • 1
    IMO this should be the accepted answer. Easier than dealing with CLI options or defining a sequencer.
    – ZCaceres
    Aug 20, 2020 at 14:49
  • 3
    This worked well for me for testing a stateful WebSocket server (connection, login, logout), which obviously must be run in the correct order. The outer describe is not required, though.
    – terrymorse
    Nov 19, 2020 at 18:46
  • 3
    This pretty much looks like implementation details which is not safe to rely upon.
    – Mesqalito
    Jun 9, 2022 at 15:28
43

It worked for me ensuring sequential running of nicely separated to modules tests:

1) Keep tests in separated files, but without spec/test in naming.

|__testsToRunSequentially.test.js
|__tests
   |__testSuite1.js
   |__testSuite2.js
   |__index.js

2) File with test suite also should look like this (testSuite1.js):

export const testSuite1 = () => describe(/*your suite inside*/)

3) Import them to testToRunSequentially.test.js and run with --runInBand:

import { testSuite1, testSuite2 } from './tests'

describe('sequentially run tests', () => {
   testSuite1()
   testSuite2()
})
1
  • 3
    You don't need to run with --runInBand since you already have two test suites. Child Test Suites are executed in sequence. May 27, 2019 at 13:31
21

Use the serial test runner:

npm install jest-serial-runner --save-dev

Set up jest to use it, e.g. in jest.config.js:

module.exports = {
   ...,
   runner: 'jest-serial-runner'
};

You could use the project feature to apply it only to a subset of tests. See https://jestjs.io/docs/en/configuration#projects-arraystring--projectconfig

4
  • You could use the project feature to use it for only a subset of tests., How?
    – Nux
    Feb 1, 2020 at 9:25
  • 1
    @Nux The 'projects' config setting in Jest lets you apply other configuration settings selectively to specific sets of tests. Answer updated with link to docs and example. Feb 5, 2020 at 8:35
  • Any idea how to use it with --testRunner parameter? This is for CI/CD only, I don't want to amend my runner in the configuration. Also, I am not talking about --runInBand option. Jul 25, 2021 at 11:32
  • This is the answer that has helped me after 2 hours of research
    – FR073N
    Nov 17, 2023 at 19:57
16

As copied from https://github.com/facebook/jest/issues/6194#issuecomment-419837314

test.spec.js

import { signuptests } from './signup'
import { logintests } from './login'

describe('Signup', signuptests)
describe('Login', logintests)

signup.js

export const signuptests = () => {
     it('Should have login elements', () => {});
     it('Should Signup', () => {}});
}

login.js

export const logintests = () => {
    it('Should Login', () => {}});
}
15

Just in case anyone wants to keep all jest configuration in the package.json options.

runInBand does not seem to be a valid config option. This means that you can end up with the setup below which does not seem 100% perfect.

"scripts": {
    "test": "jest  --runInBand"
},
...
"jest": {
    "verbose": true,
    "forceExit": true,
    "preset": "ts-jest",
    "testURL": "http://localhost/",
    "testRegex": "\\.test\\.ts$",
    ...
  }
...

However, you can add the runInBand using maxWorkers option like below:

  "scripts": {
        "test": "jest"
    },
    ...
    "jest": {
        "verbose": true,
        "maxWorkers": 1,
        "forceExit": true,
        "preset": "ts-jest",
        "testURL": "http://localhost/",
        "testRegex": "\\.test\\.ts$",
        ...
      }
    ...
2
  • 1
    Adding maxWorkers to jest.config.ts is what solved it for me Sep 13, 2022 at 16:47
  • Great, I was looking for this. It is not obvious what is difference between maxConcurrency and maxWorkers
    – Michael S
    Mar 8 at 9:23
14

I needed this for handling end-to-end tests alongside regular tests, and the runInBand solution was not enough for me. Yes: it ensures within test suites/files that the order works, but the files themselves run in an order chosen essentially for parallelization by Jest, and it's not easy to control. If you need a stable sequential order for the test suites themselves, this is how you can do it.

So in addition to the --runInBand, I did the following. I'm using separate projects for this, by the way, within a single repository.

  1. My jest.config.js looks like this:

     module.exports = {
       testSequencer: "./__e2e__/jest/customSequencer.js",
       projects: [{
         "rootDir": "<rootDir>/__e2e__",
         "displayName": "end-to-end",
         ...
    

    Here, I explicitly added the displayName to be end-to-end, which I'll use later. You can have as many projects as you like, as usual, but I have two, one for normal unit tests, and one for end-to-end.

    Note that the testSequencer field has to be global. If you attach it to a project, it'll be validated but then ignored silently. That's a Jest decision to make sequencing nice for running multiple projects.

  2. The testSequencer field points to a file containing this. This imports a default version of the test sequencer, and then partitions the tests into two sets, one for the tests in the end-to-end project, and all the rest. All the rest are delegated to the inherited sequencer, but those in the end to end set are sorted alphabetically and then concatenated.

     const Sequencer = require('@jest/test-sequencer').default;
    
     const isEndToEnd = (test) => {
       const contextConfig = test.context.config;
       return contextConfig.displayName.name === 'end-to-end';
     };
    
     class CustomSequencer extends Sequencer {
       sort(tests) {
         const copyTests = Array.from(tests);
         const normalTests = copyTests.filter((t) => ! isEndToEnd(t));
         const endToEndTests = copyTests.filter((t) => isEndToEnd(t));
         return super.sort(normalTests).concat(endToEndTests.sort((a, b) => (a.path > b.path ? 1 : -1)));
       }
     }
    
     module.exports = CustomSequencer;
    

This combo runs all the regular tests as Jest likes, but always runs the end to end ones at the end in alpha order, giving my end-to-end tests the extra stability for user models the order they need.

1
6

Yes, and you can also run all tests in a specific order, although generally your tests should be independent so I'd strongly caution against relying on any specific ordering. Having said that, there may be a valid case for controlling the test order, so you could do this:

  • Add --runInBand as an option when running jest, e.g. in package.json. This will run tests in sequence rather than in parallel (asynchronously). Using --runInBand can prevent issues like setup/teardown/cleanup in one set of tests intefering with other tests:

  • "scripts": {"test": "jest --runInBand"}

  • Put all tests into separate folder (e.g. a separate folder under __tests__, named test_suites):

    __tests__

    test_suites

    test1.js

    test2.js

  • Configure jest in package.json to ignore this test_suites folder: "jest": { "testPathIgnorePatterns": ["/test_suites"] }

  • Create a new file under __tests__ e.g. tests.js - this is now the only test file that will actually run.

  • In tests.js, require the individual test files in the order that you want to run them:

    require('./test_suites/test1.js');

    require('./test_suites/test2.js');

Note - this will cause the afterAll() in the tests to be run once all tests have completed. Essentially it's breaking the independence of tests and should be used in very limited scenarios.

5

If you are a newbie in Jest and looking for a complete, step-by-step example on how to make a specific test file ALWAYS run first or last, here it goes:

  1. Create a file called "testSequencer.js" in any path you'd like.
  2. Paste the code below into that file.
const TestSequencer = require('@jest/test-sequencer').default;
const path = require('path');

class CustomSequencer extends TestSequencer {
    sort(tests) {
        const target_test_path = path.join(__dirname, 'target.test.js');

        const target_test_index = tests.findIndex(t => t.path === target_test_path);

        if (target_test_index == -1) {
            return tests;
        }

        const target_test = tests[target_test_index];

        const ordered_tests = tests.slice();

        ordered_tests.splice(target_test_index, 1);
        ordered_tests.push(target_test); // adds to the tail
        // ordered_tests.unshift(target_test); // adds to the head

        return ordered_tests;
    }
}

module.exports = CustomSequencer;
  1. Set "maxWorkers" option as "1" in your package.json jest configuration. Also, set "testSequencer" option as your newly created "testSequencer.js" file's path.
{
  "name": "myApp",
  "version": "1.0.0",
  "main": "app.js",
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "jest"
  },
  "author": "Company",
  "license": "MIT",
  "dependencies": {
    ...
  },
  "devDependencies": {
    "jest": "^27.5.1",
    ...
  },
  "jest": {
    "testSequencer": "./testSequencer.js",
    "maxWorkers": 1
  }
}
  1. Run npm test and observe that every test file will be run one by one, upon completion of each. You sacrifice some time, but you guarantee the order this way.

Bonus: You can also order your test files alphabetically, by folder name etc. Just modify "testSequencer.js" file to your preference, and return an array that's in the same format as the "tests" array, which is a parameter of your main "sort" function, and you will be good.

4

From the Jest documentation:

Jest executes all describe handlers in a test file before it executes any of the actual tests. This is another reason to do setup and teardown inside before* and after* handlers rather than inside the describe blocks.

Once the describe blocks are complete, by default Jest runs all the tests serially in the order they were encountered in the collection phase, waiting for each to finish and be tidied up before moving on.

Take a look at the example that the jest site gives.

1
  • 3
    The problem also comes when you have different test files with different before* and after*. Imagine you use a real database to run the tests against it. If you run them in parallel there will be conflicts. It really depends on the type of testing you have setup.
    – kimy82
    Jun 11, 2021 at 10:46
0

Jest runs all the tests serially in the order they were encountered in the collection phase

You can leverage that and create special test file alltests.ordered-test.js:

import './first-test'
import './second-test'
// etc.

And add a jest config with testMatch that would run test with that file name.

That will load each file in that order thus execute them in the same order.

0

I tried a couple of methods mentioned above, but none of them seems to work. Probably due to I don't get the configuration right. Below is what works for me

  1. I set the sequence of execution in script.sh as below
# ./script.sh
npm test pretest

node dosomething.js # this call will take a while to finish

npm test posttest
  1. chmod 755 script.sh
  2. ./script.sh

Basically, pretest and posttest are the names of tests. Each of them has a corresponding test file name (pretest.test.js and posttest.test.js) under the __ tests __ directory.

0

for me this was the solution and i renamed some directories numerically to ensure the sequence.

https://jestjs.io/docs/configuration#testsequencer-string

some code from jest page:

custom-sequencer.js

const Sequencer = require('@jest/test-sequencer').default;

class CustomSequencer extends Sequencer {
  /**
   * Select tests for shard requested via --shard=shardIndex/shardCount
   * Sharding is applied before sorting
   */
  shard(tests, {shardIndex, shardCount}) {
    const shardSize = Math.ceil(tests.length / shardCount);
    const shardStart = shardSize * (shardIndex - 1);
    const shardEnd = shardSize * shardIndex;

    return [...tests]
      .sort((a, b) => (a.path > b.path ? 1 : -1))
      .slice(shardStart, shardEnd);
  }

  /**
   * Sort test to determine order of execution
   * Sorting is applied after sharding
   */
  sort(tests) {
    // Test structure information
    // https://github.com/jestjs/jest/blob/6b8b1404a1d9254e7d5d90a8934087a9c9899dab/packages/jest-runner/src/types.ts#L17-L21
    const copyTests = Array.from(tests);
    return copyTests.sort((testA, testB) => (testA.path > testB.path ? 1 : -1));
  }
}

module.exports = CustomSequencer;

jest.config.js

const config = {
  //....
  testSequencer: 'path/to/custom-sequencer.js',
  //....
};
2
  • While this link may answer the question, it is better to include the essential parts of the answer here and provide the link for reference. Link-only answers can become invalid if the linked page changes. - From Review Dec 18, 2023 at 5:18
  • added some code from jest page, the same code i used.
    – RATriches
    Dec 26, 2023 at 18:43

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.