Target Node 24 and replace fast-glob with fs.glob

5.0.0 (2025-12-13)

We have removed the usage of npm package fast-glob in favor of inbuilt fs.glob method that is part of the Node.js platform. Since, most of the Japa projects uses standard glob expressions, this change wouldn't cause any issues. However, if you were using advanced glob expressions that aren't supported by Node, then feel free to create an issue

Features

• remove fast-glob package in favor of Node.js fs.glob f70c3e0

BREAKING CHANGES

• The globs support behavior may different. However, we expect most Japa
  projects to use standard glob expressions and must work without any issues

Full Changelog: v4.4.0...v5.0.0

Add support for listing pinned tests and fail test suite when there are pinned tests

4.4.0 (2025-08-12)

disallowPinnedTests Plugin

The disallowPinnedTests plugin can be used to fail the test suite when there are one or more pinned tests. You may use it to disallow pinning tests when running in CI.

import { disallowPinnedTests } from '@japa/runner/plugins'

configure({
   plugins: [disallowPinnedTests({ disallow: !!process.env.CI })]
})

List pinned tests

The --list-pinned flag can be used to view a list of all the pinned tests along with their source code location.

node bin/test.ts --list-pinned

Features

• add CLI flag to list pinned tests (5a60016)
• add disallowPinnedTests plugin (94a966f)

Full Changelog: v4.3.1...v4.4.0

Replace deprecated find-cache-dir package with find-cache-directory

4.3.1 (2025-08-07)

Bug Fixes

• replace deprecated find-cache-dir (#67) (b0e856d)

What's Changed

• fix: replace deprecated find-cache-dir by @targos in #67

New Contributors

• @targos made their first contribution in #67

Full Changelog: v4.3.0...v4.3.1

Add getActiveTestOrFail method and return group from test.group method

4.3.0 (2025-07-21)

Features

• add getActiveTestOrFail method (#65) (73a0b6e)

What's Changed

• test.group() returns created group by @pomarec in #64
• feat: add getActiveTestOrFail method by @Julien-R44 in #65

New Contributors

• @pomarec made their first contribution in #64

Full Changelog: v4.2.0...v4.3.0

Add more debug logs

4.2.0 (2025-01-28)

Features

• add more debug logs for easier debugging (0480c8a)

Full Changelog: v4.1.0...v4.2.0

Add Github annotations reporter

The Github annotations reporter reports test errors as workflow annotations. The reporter gets activated automatically in the Github actions environment

4.1.0 (2025-01-09)

Bug Fixes

• incorrect base reporter import (5780063)
• use unix slash in github annotations (a29115f)

Features

• add github annotations reporter (23c7762)
• enable github reporter when running in Github actions CI (9da5475)
• make reporter private methods protected (d3e18a5)

Full Changelog: v4.0.0...v4.1.0

Test macros, support for bail mode and some breaking changes

4.0.0 (2025-01-06)

Test macros

Test macros are reusable test bound functions that can create and destroy resources around the lifecycle of a test. You can learn more about them in the docs and this tweet. https://x.com/AmanVirk1/status/1876135855074488589

Bail mode

In bail mode, all the upcoming tests after the failing test will be skipped. You could enable the bail mode in CI/CD pipelines to early exit the workflow after having a failing test. The bail mode is enabled using the --bail flag.

Changes to styling of subtext

The subtext refers to the text displayed by the spec reporter for the skipped and the regression tests. Earlier, the subtext was displayed in the same color as the test title. Now it is displayed as dimmed text with small tweaks to the styling. Please refer the following screenshots for the same.

Before

After

Bug Fixes

• remove failed CLI flag from the string array (31e38ca)

Code Refactoring

• rename createDiverseTests to createDummyTests (07ea6bc)

Features

• add support for bail mode (cf64cf9)
• add test.macro to define test bound reusable functions (83ff323)
• change styling of subtext (663dcbe)
• point timeout and regression errors to the test callback (d0462fb)
• serialize suite errors in ndjson reporter (5a8a9f9)

BREAKING CHANGES

• Rename createDiverseTest to createDummyTests exported via @japa/runner/factories

Full Changelog: v3.1.4...v4.0.0

Detect colors support before using ansi colors

• fix: remove hardcoded uses of colors.ansi with internal helper 56e5918

v3.1.3...v3.1.4

Full Changelog: v3.1.3...v3.1.4

Respect color support before using ansi colors

• fix: respect color support before using ansi colors b7be1a5

Full Changelog: v3.1.2...v3.1.3

Update dependencies

• chore: update dependencies bceba2f

Full Changelog: v3.1.1...v3.1.2