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
Last release 6 days ago
28 Sep 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
1 version withdrawn
withdrawn after publishing
9 years old
299 releases · first in 2018
Add RabbitMQ module @gundersong
Add OneShotWaitStrategy @omerlh
OneShotWaitStrategy @omerlh (#730)One column per quarter.
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
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →