Skip to content
JS
Package

testcontainers

Testcontainers is a NodeJS library that supports tests, providing lightweight, throwaway instances of common databases, Selenium web browsers, or anything else that can run in a Docker container

v12.1.0, 4 Aug 2026MITCommonJSTypes: BundledTesting
$ npm install testcontainers
npmGitHubHomepage

Key numbers

As of 25 Sept 2026
Weekly downloads
4.6m
+222% over 12 months
Gzip bundle size
-
No Bundlephobia data
Dependencies
15
Direct, from package.json
Last release
1 month ago
v12.1.0
GitHub stars
2.6k
272 forks
Open issues / PRs
2 / 11
Contributors
-
Commits, last 52 weeks
195

Downloads

Last week 2026-09-15 to 2026-09-21
02m4m6m8mSept 2025Mar 2026Sept 2026High 6.3m (25 Aug 2026)Low 849.6k (23 Dec 2025)
Weekly npm downloads, one point per week, weeks starting 23 Sept 2025 to 15 Sept 2026. The y axis starts at zero.

4,564,639 downloads last week, 21,531,443 in the last month. The 12-month change of +222% compares the average of the last 4 weeks with the first 4 weeks of the series.

Maintenance

Releases, last 12 months
17269 in total
Latest version
12.1.0, 4 Aug 20261 month ago
First published
6 Jan 2018
Last push to GitHub
23 Sept 20261 day before the snapshot
Repository archived
No
Open issues
2
Open pull requests
11
Commits, last 52 weeks
195
Dependents on npm
227

Major versions

  1. v12 first release 12.0.0, 19 May 2026
  2. v11 first release 11.0.0, 27 May 2025
  3. v10 first release 10.0.1, 3 Aug 2023
  4. v9 first release 9.0.0, 29 Oct 2022
  5. v8 first release 8.0.0, 10 Dec 2021
  6. v7 first release 7.0.0, 23 Jan 2021
  7. v6 first release 6.0.0, 6 Nov 2020
  8. v5 first release 5.0.0, 29 Oct 2020
  9. v4 first release 4.0.0, 17 Sept 2020
  10. v3 first release 3.0.0, 21 Jul 2020
  11. v2 first release 2.0.0, 2 Sept 2019
  12. v1 first release 1.0.5, 13 Jan 2019
  13. v0 first release 0.0.1, 6 Jan 2018

Recent releases

VersionPublished
12.1.04 Aug 2026
12.0.429 Jun 2026
12.0.317 Jun 2026
12.0.212 Jun 2026
12.0.127 May 2026
12.0.019 May 2026
11.14.08 Apr 2026
11.13.017 Mar 2026
11.12.017 Feb 2026
11.11.027 Dec 2025
11.10.09 Dec 2025
11.9.027 Nov 2025
11.8.111 Nov 2025
11.8.05 Nov 2025

Compatibility

Module format
CommonJSFrom package.json type, main and exports fields
TypeScript types
Bundled
Node.js engine range
>= 22.22
Runtimes
-
Unpacked size (npm)
250 kB
Dependencies (15)
tmpdebugbylinetar-fsundiciarchiverget-portdockerodeasync-lockdocker-composeproper-lockfile@types/dockerodeproperties-reader@balena/dockerignoressh-remote-port-forward

Install

npm install testcontainers

CDN

  • jsDelivrhttps://cdn.jsdelivr.net/npm/testcontainers@12.1.0/
  • unpkghttps://unpkg.com/testcontainers@12.1.0/
  • esm.shhttps://esm.sh/testcontainers@12.1.0

Alternatives

PackageWeekly downloadsGzipLast releaseModuleComparison
stdout-stderr83.4k-6 years agoCommonJS-
Sources: npm registry, npm downloads API, GitHub API. Data fetched 25 Sept 2026.

Indexability: Indexed.