# jest-serial-runner

> Extending the Jest default runner to run tests serially by default

Latest version **1.2.2** (published 2025-06-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install jest-serial-runner
pnpm add jest-serial-runner
yarn add jest-serial-runner
bun add jest-serial-runner
```

## Health

**Score 25/100 (F)** — status: maintenance-mode.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.2 |
| Published | 2025-06-29 |
| First published | 2018-10-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 5.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | gabrieli |
| Maintainers | gabrieli, codejedi365, evandwight |
| Keywords | jest, jest-runner, serial, runinband, run-in-band |

## Links

- npm: https://www.npmjs.com/package/jest-serial-runner
- Repository: https://github.com/gabrieli/jest-serial-runner
- Homepage: https://github.com/gabrieli/jest-serial-runner#readme
- Issues: https://github.com/gabrieli/jest-serial-runner/issues
- npm.io page: https://npm.io/package/jest-serial-runner

## Recent versions

- 1.2.2 (latest) — 2025-06-29
- 1.2.1 — 2022-11-13
- 1.2.0 — 2021-08-30
- 1.1.0 — 2019-07-05
- 1.0.1 — 2018-10-02
- 1.0.0 — 2018-10-02

## README

# `jest-serial-runner`

<p align="center">
  <a href="https://www.npmjs.com/package/jest-serial-runner">
    <img src="https://img.shields.io/npm/v/jest-serial-runner" />
  </a>
  <a href="https://github.com/gabrieli/jest-serial-runner/LICENSE.md">
    <img src="https://img.shields.io/npm/l/jest-serial-runner?color=lightgrey">
  </a>
  <a href="https://github.com/gabrieli/jest-serial-runner/releases">
    <img src="https://img.shields.io/badge/&#9741-changelog-lightgrey">
  </a>
  <a href="https://github.com/gabrieli/jest-serial-runner/actions/workflows/push.yml">
    <img src="https://github.com/gabrieli/jest-serial-runner/actions/workflows/push.yml/badge.svg?branch=master" >
  </a>
  <a href="https://github.com/gabrieli/jest-serial-runner/issues">
    <img src="https://img.shields.io/github/issues/gabrieli/jest-serial-runner">
  </a>
  <a href="https://github.com/gabrieli/jest-serial-runner/pulls">
    <img src="https://img.shields.io/github/issues-pr/gabrieli/jest-serial-runner?label=PRs">
  </a>
  <a href="https://snyk.io/advisor/npm-package/jest-serial-runner">
    <img src="https://img.shields.io/snyk/vulnerabilities/npm/jest-serial-runner">
  </a>
</p>
<p align="center">
  <img src="https://img.shields.io/npm/dependency-version/jest-serial-runner/peer/jest-runner">
  <img src="https://img.shields.io/static/v1?logo=javascript&label=JavaScript&message=CommonJs">
  <img src="https://img.shields.io/github/last-commit/gabrieli/jest-serial-runner">
</p>
<p align="center">
  <a href="https://github.com/semantic-release/semantic-release">
    <img src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg" >
  </a>
  <img src="https://img.shields.io/badge/Contributors-PR's_welcome-pink">
</p>
<p align="center">
  Extending the <a href="https://jestjs.io/">Jest</a>
  default runner to run tests serially by default
</p>

---

Simple wrapper over the default Jest runner that forces serial execution of test files. This is equivalent to running with `--runInBand` flag by default.

**Why?** Sometimes you have limited/restricted resources on the test machine (like in a docker container) and running the default `jest-runner` always runs in parallel unless specified otherwise. Integration tests are another scenario where running concurrent instances causes issues so using this runner ensures only 1 test runs at a time.

## Installation

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

## Usage

**Option 1:** Specify the runner in your `Jest` config

```jsonc
/* jest.config.json */
{
    // ...
    "runner": "jest-serial-runner"
    // ...
}
```

**Option 2:** To specify the runner for a subset of files such as for integration tests.

```js
/* jest.config.js */
module.exports = {
    // ...
    projects: [
        {
            // Uses the jest default runner for specification testing
            displayName: "UNIT",
            testMatch: ["<rootDir>/src/**/__tests__/*.spec.ts"]
        },
        {
            // Uses the serial runner instead for integration test files
            displayName: "INTEGRATION",
            runner: "jest-serial-runner",
            testMatch: ["<rootDir>/tests/**/*.integration-test.ts"]
        }
    ]
}
```

## Contributors

**Thank you to all of our [contributors](./package.json)!**

PR's & Issue contributions welcome! Please adhere to
[contributing guidelines](./CONTRIBUTING.md)
or your submission will be closed or delayed.

---
_Source: https://npm.io/package/jest-serial-runner · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._