NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
npm, #4531 most downloaded on npm
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
Latest stable
12.2.1
Last release 1 months ago
13 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
300 releases Β· first in 2018
Drag across the ruler to compare, or tap a release to open it.
Add logs around resolving a container runtime @cristianrgreco
Add RabbitMQ module @gundersong
Your coding agent can read these notes before it upgrades. Set up the MCP server β
Add OneShotWaitStrategy @omerlh
OneShotWaitStrategy @omerlh (#730)Add ChromaDB module @AlabasterAxe
_HUB_IMAGE_NAME_PREFIX provided @silh (#751)Fix error installing dependencies in Node 20x @javierlopezdeancos
Add GCloud module @anietieasuquo
Fix wait strategy for older redis versions @djakielski
Fix Couchbase module prepack script
Add support for abortOnContainerExit to HTTP wait strategy @NuShoSinkuPomogliTebeTvoiSankcii
abortOnContainerExit to HTTP wait strategy @NuShoSinkuPomogliTebeTvoiSankcii (#693)Compute list of modules for testing automatically @cristianrgreco
Fixing typo in the documentation @jespino
Add Localstack module @ilopezluna
Reuse PortForwarder container if it is running @cristianrgreco
Export @types/dockerode as a dependency @cristianrgreco
@types/dockerode as a dependency @cristianrgreco (#679)Add support for setting user, workingDir and env when executing a command in a container @LNSD
user, workingDir and env when executing a command in a container @LNSD (#668)Update minor deps @cristianrgreco
Fix Npipe strategy discovery for Windows @cristianrgreco
Add UA header to Docker runtime @cristianrgreco
DOCKER_AUTH_CONFIG example in docs @testica (#636)Add support for targeting a build stage when building a Docker image @ClaytonNorthey92
src to packages to follow workspaces convention @cristianrgreco (#631)Do not call container starting and started lifecycle hooks if container is reused @cristianrgreco
starting and started lifecycle hooks if container is reused @cristianrgreco (#625)## Changes * Update publish workflow.
Nothing published for this version
Nothing published for this version
Automatic fallback to docker-compose v2 @cristianrgreco
Nothing published for this version
Support excluding a build image from cleanup by Ryuk @cristianrgreco
Update dependency minor versions @cristianrgreco
Fix for Windows Dockerfile parsing @cristianrgreco
Update dependency minor versions @cristianrgreco
Allow both string and string[] for container exec command @cristianrgreco
string and string[] for container exec command @cristianrgreco (#589)Nothing published for this version
Add support for Testcontainers Host @cristianrgreco
Nothing published for this version
Add withLogConsumer + general logging improvements @cristianrgreco
Make stop container idempotent @cristianrgreco
Add support for docker-compose pull policy @cristianrgreco
Add support for ShellWaitStrategy @cristianrgreco
Add support for setting CPU and memory quotas @AlexPtnn
Nothing published for this version
Add support for DOCKER_HOST @cristianrgreco
DOCKER_HOST @cristianrgreco (#494)getConnectionUri convenience function for Postgres @nikeee (#472)DOCKER_AUTH_CONFIG @cristianrgreco (#476)Nothing published for this version
Nothing published for this version
Nothing published for this version
Make unit for startup timeout more obvious @mdunisch
Fix custom labels lost on reusable generic containers @henrinormak
Nothing published for this version
Add node-fetch as a dependency @cristianrgreco
Nothing published for this version
Implement StartupCheckStrategy @cristianrgreco
Retry Reaper connection, else reject @cristianrgreco
## Changes ## π¨ Breaking Changes See PR for details: - API updates @cristianrgreco
See PR for details:
Implement setting ulimits and capabilities @cristianrgreco
Provide additional options to container exec
exec (#395)Improve diagnostic logging for HostPort wait strategy @cristianrgreco
Fix Dockerode circular dependency when finding host through default gateway @cristianrgreco
Move mongoose to dev dependencies @pscanf
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.