testcontainers 9.8.0 → 9.9.0

package/README.md

@@ -24,4 +24,4 @@ See [contributors](https://github.com/testcontainers/testcontainers-node/graphs/
 
 ----
 
-Join our [Slack workspace](https://slack.testcontainers.org/) | [Testcontainers OSS](https://www.testcontainers.org/) | [Testcontainers Cloud](https://www.testcontainers.cloud/)
+Join our [Slack workspace](https://slack.testcontainers.org/) | [Testcontainers OSS](https://java.testcontainers.org/) | [Testcontainers Cloud](https://www.testcontainers.cloud/)

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "testcontainers",
     "author": "Cristian Greco",
-    "version": "9.8.0",
+    "version": "9.9.0",
     "main": "dist/src/index",
     "types": "dist/src/index",
     "keywords": [
@@ -43,13 +43,14 @@
         "async-lock": "^1.4.0",
         "byline": "^5.0.0",
         "debug": "^4.3.4",
-        "docker-compose": "^0.23.19",
+        "docker-compose": "^0.24.1",
         "dockerode": "^3.3.5",
         "get-port": "^5.1.1",
         "node-fetch": "^2.6.9",
         "properties-reader": "^2.2.0",
         "ssh-remote-port-forward": "^1.0.4",
-        "tar-fs": "^2.1.1"
+        "tar-fs": "^2.1.1",
+        "tmp": "^0.2.1"
     },
     "devDependencies": {
         "@elastic/elasticsearch": "^7.17.0",
@@ -61,7 +62,9 @@
         "@types/node-fetch": "^2.6.3",
         "@types/pg": "^8.6.6",
         "@types/properties-reader": "^2.1.1",
+        "@types/selenium-webdriver": "^4.1.14",
         "@types/tar-fs": "^2.0.1",
+        "@types/tmp": "^0.2.3",
         "@typescript-eslint/eslint-plugin": "^5.59.1",
         "@typescript-eslint/parser": "^5.59.1",
         "arangojs": "^8.2.1",
@@ -80,6 +83,7 @@
         "pg": "^8.10.0",
         "prettier": "^2.8.8",
         "rimraf": "^3.0.2",
+        "selenium-webdriver": "^4.9.2",
         "ts-jest": "^29.1.0",
         "ts-node": "^10.9.1",
         "typescript": "^4.9.5",

package/dist/src/docker/client/docker-client-config.d.ts

@@ -1,11 +1,9 @@
 /// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 export type DockerClientConfig = {
     tcHost?: string;
     dockerHost?: string;
     dockerTlsVerify?: string;
     dockerCertPath?: string;
 };
-export declare const getDockerClientConfig: (env?: NodeJS.ProcessEnv) => Promise<DockerClientConfig>;
+export type GetDockerClientConfig = (env?: NodeJS.ProcessEnv) => Promise<DockerClientConfig>;
+export declare const getDockerClientConfig: GetDockerClientConfig;

package/dist/src/docker/client/docker-client-config.js

@@ -19,9 +19,12 @@ const os_1 = require("os");
 const fs_1 = require("fs");
 const promises_1 = require("fs/promises");
 const properties_reader_1 = __importDefault(require("properties-reader"));
+let dockerClientConfig;
 const getDockerClientConfig = (env = process.env) => __awaiter(void 0, void 0, void 0, function* () {
-    const dockerClientConfig = Object.assign(Object.assign({}, (yield loadFromFile())), loadFromEnv(env));
-    logDockerClientConfig(dockerClientConfig);
+    if (!dockerClientConfig) {
+        dockerClientConfig = Object.assign(Object.assign({}, (yield loadFromFile())), loadFromEnv(env));
+        logDockerClientConfig(dockerClientConfig);
+    }
     return dockerClientConfig;
 });
 exports.getDockerClientConfig = getDockerClientConfig;

package/dist/src/docker/client/docker-client.js

@@ -35,40 +35,52 @@ function getDockerClient() {
             new npipe_socket_strategy_1.NpipeSocketStrategy(),
         ];
         for (const strategy of strategies) {
-            if (strategy.init) {
-                yield strategy.init();
-            }
-            if (strategy.isApplicable()) {
-                logger_1.log.debug(`Found Docker client strategy "${strategy.getName()}"`);
-                const { uri, dockerode, composeEnvironment, allowUserOverrides } = yield strategy.getDockerClient();
-                logger_1.log.debug(`Testing Docker client strategy "${uri}"...`);
-                if (yield isDockerDaemonReachable(dockerode)) {
-                    const info = yield (0, system_info_1.getSystemInfo)(dockerode);
-                    const containerRuntime = uri.includes("podman.sock") ? "podman" : "docker";
-                    const host = yield (0, resolve_host_1.resolveHost)(dockerode, containerRuntime, info.dockerInfo.indexServerAddress, uri, allowUserOverrides);
-                    const hostIps = yield (0, lookup_host_ips_1.lookupHostIps)(host);
-                    dockerClient = {
-                        uri,
-                        containerRuntime,
-                        host,
-                        hostIps,
-                        dockerode,
-                        info,
-                        composeEnvironment,
-                        allowUserOverrides,
-                    };
+            try {
+                const dockerClient = yield tryToCreateDockerClient(strategy);
+                if (dockerClient) {
                     logDockerClient(strategy.getName(), dockerClient);
                     return dockerClient;
                 }
-                else {
-                    logger_1.log.warn(`Docker client strategy "${strategy.getName()}" is not working`);
-                }
+            }
+            catch (err) {
+                logger_1.log.warn(`Docker client strategy "${strategy.getName()}" threw: "${err}"`);
             }
         }
         throw new Error("No Docker client strategy found");
     });
 }
 exports.getDockerClient = getDockerClient;
+function tryToCreateDockerClient(strategy) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (strategy.init) {
+            yield strategy.init();
+        }
+        if (strategy.isApplicable()) {
+            const { uri, dockerode, composeEnvironment, allowUserOverrides } = yield strategy.getDockerClient();
+            logger_1.log.debug(`Testing Docker client strategy "${strategy.getName()}" with URI "${uri}"...`);
+            if (yield isDockerDaemonReachable(dockerode)) {
+                const info = yield (0, system_info_1.getSystemInfo)(dockerode);
+                const containerRuntime = uri.includes("podman.sock") ? "podman" : "docker";
+                const host = yield (0, resolve_host_1.resolveHost)(dockerode, containerRuntime, info.dockerInfo.indexServerAddress, uri, allowUserOverrides);
+                const hostIps = yield (0, lookup_host_ips_1.lookupHostIps)(host);
+                dockerClient = {
+                    uri,
+                    containerRuntime,
+                    host,
+                    hostIps,
+                    dockerode,
+                    info,
+                    composeEnvironment,
+                    allowUserOverrides,
+                };
+                return dockerClient;
+            }
+            else {
+                logger_1.log.warn(`Docker client strategy "${strategy.getName()}" does not work`);
+            }
+        }
+    });
+}
 function isDockerDaemonReachable(dockerode) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
@@ -76,7 +88,7 @@ function isDockerDaemonReachable(dockerode) {
             return (yield (0, stream_utils_1.streamToString)(stream_1.Readable.from(response))) === "OK";
         }
         catch (err) {
-            logger_1.log.warn(`Docker daemon is not reachable: ${err}`);
+            logger_1.log.warn(`Docker daemon is not reachable: "${err}"`);
             return false;
         }
     });
@@ -86,5 +98,5 @@ function logDockerClient(strategyName, { host, hostIps }) {
         return;
     }
     const formattedHostIps = hostIps.map((hostIp) => hostIp.address).join(", ");
-    logger_1.log.info(`Using Docker client strategy "${strategyName}", Docker host "${host}" (${formattedHostIps})`);
+    logger_1.log.info(`Docker client strategy "${strategyName}" works, ${host} (${formattedHostIps})`);
 }

package/dist/src/docker/functions/container/create-container.d.ts

@@ -26,5 +26,6 @@ export type CreateContainerOptions = {
     user?: string;
     workingDir?: string;
     resourcesQuota?: ResourcesQuota;
+    sharedMemorySize?: number;
 };
 export declare const createContainer: (options: CreateContainerOptions) => Promise<Dockerode.Container>;

package/dist/src/docker/functions/container/create-container.js

@@ -45,6 +45,7 @@ const createContainer = (options) => __awaiter(void 0, void 0, void 0, function*
                 CapDrop: options.droppedCapabilities,
                 Memory: (_a = options.resourcesQuota) === null || _a === void 0 ? void 0 : _a.memory,
                 NanoCpus: (_b = options.resourcesQuota) === null || _b === void 0 ? void 0 : _b.cpu,
+                ShmSize: options.sharedMemorySize,
             },
         });
         logger_1.log.info(`Created container for image "${options.imageName}"`, { containerId: container.id });

package/dist/src/docker/functions/container/get-container-archive.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import Dockerode from "dockerode";
+export type GetContainerArchiveOptions = {
+    container: Dockerode.Container;
+    path: string;
+};
+export declare const getContainerArchive: (options: GetContainerArchiveOptions) => Promise<NodeJS.ReadableStream>;

package/dist/src/docker/functions/container/get-container-archive.js

@@ -0,0 +1,23 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContainerArchive = void 0;
+const logger_1 = require("../../../logger");
+const getContainerArchive = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return yield options.container.getArchive({ path: options.path });
+    }
+    catch (err) {
+        logger_1.log.error(`Failed to get archive from container: ${err}`, { containerId: options.container.id });
+        throw err;
+    }
+});
+exports.getContainerArchive = getContainerArchive;

package/dist/src/generic-container/generic-container.d.ts

@@ -68,5 +68,6 @@ export declare class GenericContainer implements TestContainer {
     protected getTarToCopy(): archiver.Archiver;
     withWorkingDir(workingDir: string): this;
     withResourcesQuota({ memory, cpu }: ResourcesQuota): this;
+    withSharedMemorySize(bytes: number): this;
     withLogConsumer(logConsumer: (stream: Readable) => unknown): this;
 }

package/dist/src/generic-container/generic-container.js

@@ -314,6 +314,10 @@ class GenericContainer {
         this.opts.resourcesQuota = { memory: ram, cpu: cpuQuota };
         return this;
     }
+    withSharedMemorySize(bytes) {
+        this.opts.sharedMemorySize = bytes;
+        return this;
+    }
     withLogConsumer(logConsumer) {
         this.logConsumer = logConsumer;
         return this;

package/dist/src/generic-container/started-generic-container.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { RestartOptions, StartedTestContainer, StopOptions, StoppedTestContainer } from "../test-container";
 import Dockerode from "dockerode";
-import { ExecResult, Labels } from "../docker/types";
+import { ContentToCopy, ExecResult, FileToCopy, Labels } from "../docker/types";
 import { InspectResult } from "../docker/functions/container/inspect-container";
 import { BoundPorts } from "../bound-ports";
 import { Readable } from "stream";
@@ -30,6 +31,9 @@ export declare class StartedGenericContainer implements StartedTestContainer {
     getNetworkNames(): string[];
     getNetworkId(networkName: string): string;
     getIpAddress(networkName: string): string;
-    exec(command: string[]): Promise<ExecResult>;
+    copyFilesToContainer(filesToCopy: FileToCopy[]): Promise<void>;
+    copyContentToContainer(contentsToCopy: ContentToCopy[]): Promise<void>;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
+    exec(command: string | string[]): Promise<ExecResult>;
     logs(): Promise<Readable>;
 }

package/dist/src/generic-container/started-generic-container.js

@@ -25,6 +25,9 @@ const restart_container_1 = require("../docker/functions/container/restart-conta
 const wait_for_container_1 = require("../wait-for-container");
 const docker_client_1 = require("../docker/client/docker-client");
 const async_lock_1 = __importDefault(require("async-lock"));
+const get_container_archive_1 = require("../docker/functions/container/get-container-archive");
+const archiver_1 = __importDefault(require("archiver"));
+const put_container_archive_1 = require("../docker/functions/container/put-container-archive");
 class StartedGenericContainer {
     constructor(container, host, inspectResult, boundPorts, name, waitStrategy) {
         this.container = container;
@@ -70,14 +73,16 @@ class StartedGenericContainer {
             if (this.containerIsStopping) {
                 yield this.containerIsStopping();
             }
-            const resolvedOptions = Object.assign({ timeout: 0, removeVolumes: true }, options);
+            const resolvedOptions = Object.assign({ remove: true, timeout: 0, removeVolumes: true }, options);
             yield (0, stop_container_1.stopContainer)(this.container, { timeout: resolvedOptions.timeout });
-            yield (0, remove_container_1.removeContainer)(this.container, { removeVolumes: resolvedOptions.removeVolumes });
+            if (resolvedOptions.remove) {
+                yield (0, remove_container_1.removeContainer)(this.container, { removeVolumes: resolvedOptions.removeVolumes });
+            }
             logger_1.log.info(`Stopped container`, { containerId: this.container.id });
             if (this.containerIsStopped) {
                 yield this.containerIsStopped();
             }
-            return new stopped_generic_container_1.StoppedGenericContainer();
+            return new stopped_generic_container_1.StoppedGenericContainer(this.container);
         });
     }
     getHost() {
@@ -107,12 +112,42 @@ class StartedGenericContainer {
     getIpAddress(networkName) {
         return this.inspectResult.networkSettings[networkName].ipAddress;
     }
+    copyFilesToContainer(filesToCopy) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger_1.log.debug(`Copying files to container...`, { containerId: this.container.id });
+            const tar = (0, archiver_1.default)("tar");
+            filesToCopy.forEach(({ source, target }) => tar.file(source, { name: target }));
+            tar.finalize();
+            yield (0, put_container_archive_1.putContainerArchive)({ container: this.container, stream: tar, containerPath: "/" });
+            logger_1.log.debug(`Copied files to container`, { containerId: this.container.id });
+        });
+    }
+    copyContentToContainer(contentsToCopy) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger_1.log.debug(`Copying content to container...`, { containerId: this.container.id });
+            const tar = (0, archiver_1.default)("tar");
+            contentsToCopy.forEach(({ content, target }) => tar.append(content, { name: target }));
+            tar.finalize();
+            yield (0, put_container_archive_1.putContainerArchive)({ container: this.container, stream: tar, containerPath: "/" });
+            logger_1.log.debug(`Copied content to container`, { containerId: this.container.id });
+        });
+    }
+    copyArchiveFromContainer(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger_1.log.debug(`Copying archive "${path}" from container...`, { containerId: this.container.id });
+            const stream = yield (0, get_container_archive_1.getContainerArchive)({ container: this.container, path: path });
+            logger_1.log.debug(`Copied archive "${path}" from container`, { containerId: this.container.id });
+            return stream;
+        });
+    }
     exec(command) {
         return __awaiter(this, void 0, void 0, function* () {
             const { dockerode, containerRuntime } = yield (0, docker_client_1.getDockerClient)();
-            logger_1.log.debug(`Executing command "${command.join(" ")}"...`, { containerId: this.container.id });
-            const output = yield (0, exec_container_1.execContainer)(dockerode, containerRuntime, this.container, command);
-            logger_1.log.debug(`Executed command "${command.join(" ")}"...`, { containerId: this.container.id });
+            const commandArr = Array.isArray(command) ? command : command.split(" ");
+            const commandStr = commandArr.join(" ");
+            logger_1.log.debug(`Executing command "${commandStr}"...`, { containerId: this.container.id });
+            const output = yield (0, exec_container_1.execContainer)(dockerode, containerRuntime, this.container, commandArr);
+            logger_1.log.debug(`Executed command "${commandStr}"...`, { containerId: this.container.id });
             return output;
         });
     }

package/dist/src/generic-container/stopped-generic-container.d.ts

@@ -1,3 +1,9 @@
+/// <reference types="node" />
 import { StoppedTestContainer } from "../test-container";
+import Dockerode from "dockerode";
 export declare class StoppedGenericContainer implements StoppedTestContainer {
+    private readonly container;
+    constructor(container: Dockerode.Container);
+    getId(): string;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
 }

package/dist/src/generic-container/stopped-generic-container.js

@@ -1,6 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StoppedGenericContainer = void 0;
+const get_container_archive_1 = require("../docker/functions/container/get-container-archive");
+const logger_1 = require("../logger");
 class StoppedGenericContainer {
+    constructor(container) {
+        this.container = container;
+    }
+    getId() {
+        return this.container.id;
+    }
+    copyArchiveFromContainer(path) {
+        logger_1.log.debug(`Copying archive "${path}" from container...`, { containerId: this.container.id });
+        const stream = (0, get_container_archive_1.getContainerArchive)({ container: this.container, path: path });
+        logger_1.log.debug(`Copied archive "${path}" from container`, { containerId: this.container.id });
+        return stream;
+    }
 }
 exports.StoppedGenericContainer = StoppedGenericContainer;

package/dist/src/images.js

@@ -2,5 +2,5 @@
 var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SSHD_IMAGE = exports.REAPER_IMAGE = void 0;
-exports.REAPER_IMAGE = (_a = process.env["RYUK_CONTAINER_IMAGE"]) !== null && _a !== void 0 ? _a : "testcontainers/ryuk:0.4.0";
+exports.REAPER_IMAGE = (_a = process.env["RYUK_CONTAINER_IMAGE"]) !== null && _a !== void 0 ? _a : "testcontainers/ryuk:0.5.1";
 exports.SSHD_IMAGE = (_b = process.env["SSHD_CONTAINER_IMAGE"]) !== null && _b !== void 0 ? _b : "testcontainers/sshd:1.1.0";

package/dist/src/index.d.ts

@@ -12,6 +12,7 @@ export { StartupCheckStrategy, StartupStatus } from "./wait-strategy/startup-che
 export { PullPolicy, DefaultPullPolicy, AlwaysPullPolicy } from "./pull-policy";
 export { InspectResult } from "./docker/functions/container/inspect-container";
 export { AbstractStartedContainer } from "./modules/abstract-started-container";
+export { AbstractStoppedContainer } from "./modules/abstract-stopped-container";
 export { PostgreSqlContainer, StartedPostgreSqlContainer } from "./modules/postgresql/postgresql-container";
 export { KafkaContainer, StartedKafkaContainer } from "./modules/kafka/kafka-container";
 export { Neo4jContainer, StartedNeo4jContainer } from "./modules/neo4j/neo4j-container";
@@ -20,3 +21,4 @@ export { ElasticsearchContainer, StartedElasticsearchContainer } from "./modules
 export { MySqlContainer, StartedMySqlContainer } from "./modules/mysql/mysql-container";
 export { NatsContainer, StartedNatsContainer, NatsConnectionOptions, NatsTlsOptions, } from "./modules/nats/nats-container";
 export { MongoDBContainer, StartedMongoDBContainer } from "./modules/mongodb/mongodb-container";
+export { SeleniumContainer, SeleniumRecordingContainer, StartedSeleniumContainer, StartedSeleniumRecordingContainer, StoppedSeleniumContainer, StoppedSeleniumRecordingContainer, } from "./modules/selenium/selenium-container";

package/dist/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StartedMongoDBContainer = exports.MongoDBContainer = exports.StartedNatsContainer = exports.NatsContainer = exports.StartedMySqlContainer = exports.MySqlContainer = exports.StartedElasticsearchContainer = exports.ElasticsearchContainer = exports.StartedArangoContainer = exports.ArangoDBContainer = exports.StartedNeo4jContainer = exports.Neo4jContainer = exports.StartedKafkaContainer = exports.KafkaContainer = exports.StartedPostgreSqlContainer = exports.PostgreSqlContainer = exports.AbstractStartedContainer = exports.AlwaysPullPolicy = exports.DefaultPullPolicy = exports.StartupCheckStrategy = exports.Wait = exports.StoppedNetwork = exports.StartedNetwork = exports.Network = exports.DownedDockerComposeEnvironment = exports.StoppedDockerComposeEnvironment = exports.StartedDockerComposeEnvironment = exports.DockerComposeEnvironment = exports.TestContainers = exports.GenericContainerBuilder = exports.GenericContainer = void 0;
+exports.StoppedSeleniumRecordingContainer = exports.StoppedSeleniumContainer = exports.StartedSeleniumRecordingContainer = exports.StartedSeleniumContainer = exports.SeleniumRecordingContainer = exports.SeleniumContainer = exports.StartedMongoDBContainer = exports.MongoDBContainer = exports.StartedNatsContainer = exports.NatsContainer = exports.StartedMySqlContainer = exports.MySqlContainer = exports.StartedElasticsearchContainer = exports.ElasticsearchContainer = exports.StartedArangoContainer = exports.ArangoDBContainer = exports.StartedNeo4jContainer = exports.Neo4jContainer = exports.StartedKafkaContainer = exports.KafkaContainer = exports.StartedPostgreSqlContainer = exports.PostgreSqlContainer = exports.AbstractStoppedContainer = exports.AbstractStartedContainer = exports.AlwaysPullPolicy = exports.DefaultPullPolicy = exports.StartupCheckStrategy = exports.Wait = exports.StoppedNetwork = exports.StartedNetwork = exports.Network = exports.DownedDockerComposeEnvironment = exports.StoppedDockerComposeEnvironment = exports.StartedDockerComposeEnvironment = exports.DockerComposeEnvironment = exports.TestContainers = exports.GenericContainerBuilder = exports.GenericContainer = void 0;
 var generic_container_1 = require("./generic-container/generic-container");
 Object.defineProperty(exports, "GenericContainer", { enumerable: true, get: function () { return generic_container_1.GenericContainer; } });
 var generic_container_builder_1 = require("./generic-container/generic-container-builder");
@@ -28,6 +28,8 @@ Object.defineProperty(exports, "DefaultPullPolicy", { enumerable: true, get: fun
 Object.defineProperty(exports, "AlwaysPullPolicy", { enumerable: true, get: function () { return pull_policy_1.AlwaysPullPolicy; } });
 var abstract_started_container_1 = require("./modules/abstract-started-container");
 Object.defineProperty(exports, "AbstractStartedContainer", { enumerable: true, get: function () { return abstract_started_container_1.AbstractStartedContainer; } });
+var abstract_stopped_container_1 = require("./modules/abstract-stopped-container");
+Object.defineProperty(exports, "AbstractStoppedContainer", { enumerable: true, get: function () { return abstract_stopped_container_1.AbstractStoppedContainer; } });
 var postgresql_container_1 = require("./modules/postgresql/postgresql-container");
 Object.defineProperty(exports, "PostgreSqlContainer", { enumerable: true, get: function () { return postgresql_container_1.PostgreSqlContainer; } });
 Object.defineProperty(exports, "StartedPostgreSqlContainer", { enumerable: true, get: function () { return postgresql_container_1.StartedPostgreSqlContainer; } });
@@ -52,3 +54,10 @@ Object.defineProperty(exports, "StartedNatsContainer", { enumerable: true, get:
 var mongodb_container_1 = require("./modules/mongodb/mongodb-container");
 Object.defineProperty(exports, "MongoDBContainer", { enumerable: true, get: function () { return mongodb_container_1.MongoDBContainer; } });
 Object.defineProperty(exports, "StartedMongoDBContainer", { enumerable: true, get: function () { return mongodb_container_1.StartedMongoDBContainer; } });
+var selenium_container_1 = require("./modules/selenium/selenium-container");
+Object.defineProperty(exports, "SeleniumContainer", { enumerable: true, get: function () { return selenium_container_1.SeleniumContainer; } });
+Object.defineProperty(exports, "SeleniumRecordingContainer", { enumerable: true, get: function () { return selenium_container_1.SeleniumRecordingContainer; } });
+Object.defineProperty(exports, "StartedSeleniumContainer", { enumerable: true, get: function () { return selenium_container_1.StartedSeleniumContainer; } });
+Object.defineProperty(exports, "StartedSeleniumRecordingContainer", { enumerable: true, get: function () { return selenium_container_1.StartedSeleniumRecordingContainer; } });
+Object.defineProperty(exports, "StoppedSeleniumContainer", { enumerable: true, get: function () { return selenium_container_1.StoppedSeleniumContainer; } });
+Object.defineProperty(exports, "StoppedSeleniumRecordingContainer", { enumerable: true, get: function () { return selenium_container_1.StoppedSeleniumRecordingContainer; } });

package/dist/src/modules/abstract-started-container.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { RestartOptions, StartedTestContainer, StopOptions, StoppedTestContainer } from "../test-container";
-import { ExecResult, Labels } from "../docker/types";
+import { ContentToCopy, ExecResult, FileToCopy, Labels } from "../docker/types";
 import { Readable } from "stream";
 export declare class AbstractStartedContainer implements StartedTestContainer {
     protected readonly startedTestContainer: StartedTestContainer;
@@ -18,6 +19,9 @@ export declare class AbstractStartedContainer implements StartedTestContainer {
     getNetworkNames(): string[];
     getNetworkId(networkName: string): string;
     getIpAddress(networkName: string): string;
-    exec(command: string[]): Promise<ExecResult>;
+    copyFilesToContainer(filesToCopy: FileToCopy[]): Promise<void>;
+    copyContentToContainer(contentsToCopy: ContentToCopy[]): Promise<void>;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
+    exec(command: string | string[]): Promise<ExecResult>;
     logs(): Promise<Readable>;
 }

package/dist/src/modules/abstract-started-container.js

@@ -58,6 +58,19 @@ class AbstractStartedContainer {
     getIpAddress(networkName) {
         return this.startedTestContainer.getIpAddress(networkName);
     }
+    copyFilesToContainer(filesToCopy) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.startedTestContainer.copyFilesToContainer(filesToCopy);
+        });
+    }
+    copyContentToContainer(contentsToCopy) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.startedTestContainer.copyContentToContainer(contentsToCopy);
+        });
+    }
+    copyArchiveFromContainer(path) {
+        return this.startedTestContainer.copyArchiveFromContainer(path);
+    }
     exec(command) {
         return this.startedTestContainer.exec(command);
     }

package/dist/src/modules/abstract-stopped-container.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+import { StoppedTestContainer } from "../test-container";
+export declare class AbstractStoppedContainer implements StoppedTestContainer {
+    protected readonly stoppedTestContainer: StoppedTestContainer;
+    constructor(stoppedTestContainer: StoppedTestContainer);
+    getId(): string;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
+}

package/dist/src/modules/abstract-stopped-container.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractStoppedContainer = void 0;
+class AbstractStoppedContainer {
+    constructor(stoppedTestContainer) {
+        this.stoppedTestContainer = stoppedTestContainer;
+    }
+    getId() {
+        return this.stoppedTestContainer.getId();
+    }
+    copyArchiveFromContainer(path) {
+        return this.stoppedTestContainer.copyArchiveFromContainer(path);
+    }
+}
+exports.AbstractStoppedContainer = AbstractStoppedContainer;

package/dist/src/modules/kafka/kafka-container.js

@@ -122,7 +122,12 @@ class KafkaContainer extends generic_container_1.GenericContainer {
             const brokerAdvertisedListener = `BROKER://${inspectResult.hostname}:${KAFKA_BROKER_PORT}`;
             let bootstrapServers = `PLAINTEXT://${container.getHost()}:${container.getMappedPort(KAFKA_PORT)}`;
             if (this.saslSslConfig) {
-                bootstrapServers = `${bootstrapServers},SECURE://${container.getHost()}:${container.getMappedPort(this.saslSslConfig.port)}`;
+                if (this.networkMode) {
+                    bootstrapServers = `${bootstrapServers},SECURE://${inspectResult.hostname}:${this.saslSslConfig.port}`;
+                }
+                else {
+                    bootstrapServers = `${bootstrapServers},SECURE://${container.getHost()}:${container.getMappedPort(this.saslSslConfig.port)}`;
+                }
             }
             const { output, exitCode } = yield container.exec([
                 "kafka-configs",

package/dist/src/modules/mysql/mysql-container.d.ts

@@ -25,5 +25,6 @@ export declare class StartedMySqlContainer extends AbstractStartedContainer {
     getUsername(): string;
     getUserPassword(): string;
     getRootPassword(): string;
+    getConnectionUri(isRoot?: boolean): string;
     executeQuery(query: string, additionalFlags?: string[]): Promise<string>;
 }

package/dist/src/modules/mysql/mysql-container.js

@@ -79,6 +79,15 @@ class StartedMySqlContainer extends abstract_started_container_1.AbstractStarted
     getRootPassword() {
         return this.rootPassword;
     }
+    getConnectionUri(isRoot = false) {
+        const url = new URL("", "mysql://");
+        url.hostname = this.getHost();
+        url.port = this.getPort().toString();
+        url.pathname = this.getDatabase();
+        url.username = isRoot ? "root" : this.getUsername();
+        url.password = isRoot ? this.getRootPassword() : this.getUserPassword();
+        return url.toString();
+    }
     executeQuery(query, additionalFlags = []) {
         return __awaiter(this, void 0, void 0, function* () {
             const result = yield this.startedTestContainer.exec([

package/dist/src/modules/selenium/selenium-container.d.ts

@@ -0,0 +1,38 @@
+import { GenericContainer } from "../../generic-container/generic-container";
+import { AbstractStartedContainer } from "../abstract-started-container";
+import { StartedTestContainer, StopOptions, StoppedTestContainer } from "../../test-container";
+import { AbstractStoppedContainer } from "../abstract-stopped-container";
+import { StartedNetwork } from "../../network";
+export declare const SELENIUM_VIDEO_IMAGE = "selenium/video:ffmpeg-4.3.1-20230508";
+export declare class SeleniumContainer extends GenericContainer {
+    constructor(image?: string);
+    protected beforeContainerStarted(): Promise<void>;
+    withRecording(): SeleniumRecordingContainer;
+    start(): Promise<StartedSeleniumContainer>;
+}
+export declare class StartedSeleniumContainer extends AbstractStartedContainer {
+    private readonly serverUrl;
+    constructor(startedTestContainer: StartedTestContainer);
+    getServerUrl(): string;
+    stop(options?: Partial<StopOptions>): Promise<StoppedSeleniumContainer>;
+}
+export declare class StoppedSeleniumContainer extends AbstractStoppedContainer {
+    private readonly stoppedSeleniumContainer;
+    constructor(stoppedSeleniumContainer: StoppedTestContainer);
+}
+export declare class SeleniumRecordingContainer extends SeleniumContainer {
+    constructor(image: string);
+    start(): Promise<StartedSeleniumRecordingContainer>;
+}
+export declare class StartedSeleniumRecordingContainer extends StartedSeleniumContainer {
+    private readonly startedFfmpegContainer;
+    private readonly network;
+    constructor(startedSeleniumContainer: StartedTestContainer, startedFfmpegContainer: StartedTestContainer, network: StartedNetwork);
+    stop(options?: Partial<StopOptions>): Promise<StoppedSeleniumRecordingContainer>;
+}
+export declare class StoppedSeleniumRecordingContainer extends StoppedSeleniumContainer {
+    private readonly stoppedFfmpegContainer;
+    constructor(stoppedSeleniumContainer: StoppedTestContainer, stoppedFfmpegContainer: StoppedTestContainer);
+    saveRecording(target: string): Promise<void>;
+    private extractTarStreamToDest;
+}

package/dist/src/modules/selenium/selenium-container.js

@@ -0,0 +1,158 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoppedSeleniumRecordingContainer = exports.StartedSeleniumRecordingContainer = exports.SeleniumRecordingContainer = exports.StoppedSeleniumContainer = exports.StartedSeleniumContainer = exports.SeleniumContainer = exports.SELENIUM_VIDEO_IMAGE = void 0;
+const generic_container_1 = require("../../generic-container/generic-container");
+const abstract_started_container_1 = require("../abstract-started-container");
+const wait_1 = require("../../wait-strategy/wait");
+const abstract_stopped_container_1 = require("../abstract-stopped-container");
+const network_1 = require("../../network");
+const logger_1 = require("../../logger");
+const promises_1 = require("fs/promises");
+const tmp_1 = __importDefault(require("tmp"));
+const tar_fs_1 = __importDefault(require("tar-fs"));
+const path_1 = __importDefault(require("path"));
+const SELENIUM_PORT = 4444;
+const VNC_PORT = 5900;
+const SELENIUM_NETWORK_ALIAS = "selenium";
+exports.SELENIUM_VIDEO_IMAGE = "selenium/video:ffmpeg-4.3.1-20230508";
+class SeleniumContainer extends generic_container_1.GenericContainer {
+    constructor(image = "selenium/standalone-chrome:112.0") {
+        super(image);
+    }
+    beforeContainerStarted() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.withExposedPorts(SELENIUM_PORT, VNC_PORT)
+                .withSharedMemorySize(2 * 1024 * 1024 * 1024)
+                .withWaitStrategy(wait_1.Wait.forHttp("/wd/hub/status", SELENIUM_PORT).forResponsePredicate((response) => {
+                try {
+                    return JSON.parse(response).value.ready;
+                }
+                catch (_a) {
+                    return false;
+                }
+            }));
+        });
+    }
+    withRecording() {
+        return new SeleniumRecordingContainer(this.image);
+    }
+    start() {
+        const _super = Object.create(null, {
+            start: { get: () => super.start }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            return new StartedSeleniumContainer(yield _super.start.call(this));
+        });
+    }
+}
+exports.SeleniumContainer = SeleniumContainer;
+class StartedSeleniumContainer extends abstract_started_container_1.AbstractStartedContainer {
+    constructor(startedTestContainer) {
+        super(startedTestContainer);
+        this.serverUrl = `http://${this.getHost()}:${this.getMappedPort(4444)}/wd/hub`;
+    }
+    getServerUrl() {
+        return this.serverUrl;
+    }
+    stop(options) {
+        const _super = Object.create(null, {
+            stop: { get: () => super.stop }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            return new StoppedSeleniumContainer(yield _super.stop.call(this, options));
+        });
+    }
+}
+exports.StartedSeleniumContainer = StartedSeleniumContainer;
+class StoppedSeleniumContainer extends abstract_stopped_container_1.AbstractStoppedContainer {
+    constructor(stoppedSeleniumContainer) {
+        super(stoppedSeleniumContainer);
+        this.stoppedSeleniumContainer = stoppedSeleniumContainer;
+    }
+}
+exports.StoppedSeleniumContainer = StoppedSeleniumContainer;
+class SeleniumRecordingContainer extends SeleniumContainer {
+    constructor(image) {
+        super(image);
+    }
+    start() {
+        const _super = Object.create(null, {
+            start: { get: () => super.start }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            const network = yield new network_1.Network().start();
+            this.withNetwork(network);
+            this.withNetworkAliases(SELENIUM_NETWORK_ALIAS);
+            const startedSeleniumContainer = yield _super.start.call(this);
+            const startedFfmpegContainer = yield new generic_container_1.GenericContainer(exports.SELENIUM_VIDEO_IMAGE)
+                .withNetwork(network)
+                .withEnvironment({ DISPLAY_CONTAINER_NAME: SELENIUM_NETWORK_ALIAS })
+                .withWaitStrategy(wait_1.Wait.forLogMessage(/.*video-recording entered RUNNING state.*/))
+                .start();
+            return new StartedSeleniumRecordingContainer(startedSeleniumContainer, startedFfmpegContainer, network);
+        });
+    }
+}
+exports.SeleniumRecordingContainer = SeleniumRecordingContainer;
+class StartedSeleniumRecordingContainer extends StartedSeleniumContainer {
+    constructor(startedSeleniumContainer, startedFfmpegContainer, network) {
+        super(startedSeleniumContainer);
+        this.startedFfmpegContainer = startedFfmpegContainer;
+        this.network = network;
+    }
+    stop(options) {
+        const _super = Object.create(null, {
+            stop: { get: () => super.stop }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            const stoppedSeleniumContainer = yield _super.stop.call(this, options);
+            const stoppedFfmpegContainer = yield this.startedFfmpegContainer.stop({ remove: false, timeout: 60000 });
+            yield this.network.stop();
+            return new StoppedSeleniumRecordingContainer(stoppedSeleniumContainer, stoppedFfmpegContainer);
+        });
+    }
+}
+exports.StartedSeleniumRecordingContainer = StartedSeleniumRecordingContainer;
+class StoppedSeleniumRecordingContainer extends StoppedSeleniumContainer {
+    constructor(stoppedSeleniumContainer, stoppedFfmpegContainer) {
+        super(stoppedSeleniumContainer);
+        this.stoppedFfmpegContainer = stoppedFfmpegContainer;
+    }
+    saveRecording(target) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const ffmpegContainerId = this.stoppedFfmpegContainer.getId();
+            logger_1.log.debug("Extracting archive from container...", { containerId: ffmpegContainerId });
+            const archiveStream = yield this.stoppedFfmpegContainer.copyArchiveFromContainer("/videos/video.mp4");
+            logger_1.log.debug("Extracted archive from container", { containerId: ffmpegContainerId });
+            logger_1.log.debug("Unpacking archive...", { containerId: ffmpegContainerId });
+            const destinationDir = tmp_1.default.dirSync({ keep: false });
+            yield this.extractTarStreamToDest(archiveStream, destinationDir.name);
+            logger_1.log.debug("Unpacked archive", { containerId: ffmpegContainerId });
+            const videoFile = path_1.default.resolve(destinationDir.name, "video.mp4");
+            yield (0, promises_1.copyFile)(videoFile, target);
+            logger_1.log.debug(`Extracted video to "${target}"`, { containerId: ffmpegContainerId });
+        });
+    }
+    extractTarStreamToDest(tarStream, dest) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield new Promise((resolve) => {
+                const destination = tar_fs_1.default.extract(dest);
+                tarStream.pipe(destination);
+                destination.on("finish", resolve);
+            });
+        });
+    }
+}
+exports.StoppedSeleniumRecordingContainer = StoppedSeleniumRecordingContainer;

package/dist/src/test-container.d.ts

@@ -1,9 +1,10 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { PortWithOptionalBinding } from "./port";
 import { PullPolicy } from "./pull-policy";
 import { WaitStrategy } from "./wait-strategy/wait-strategy";
 import { Readable } from "stream";
-import { ExecResult, ExtraHost, TmpFs, Labels, Ulimits, BindMount, FileToCopy, ContentToCopy, Environment, ResourcesQuota } from "./docker/types";
+import { BindMount, ContentToCopy, Environment, ExecResult, ExtraHost, FileToCopy, Labels, ResourcesQuota, TmpFs, Ulimits } from "./docker/types";
 import { StartedNetwork } from "./network";
 export interface TestContainer {
     start(): Promise<StartedTestContainer>;
@@ -30,6 +31,7 @@ export interface TestContainer {
     withCopyContentToContainer(contentsToCopy: ContentToCopy[]): this;
     withWorkingDir(workingDir: string): this;
     withResourcesQuota(resourcesQuota: ResourcesQuota): this;
+    withSharedMemorySize(bytes: number): this;
     withLogConsumer(logConsumer: (stream: Readable) => unknown): this;
 }
 export interface RestartOptions {
@@ -37,6 +39,7 @@ export interface RestartOptions {
 }
 export interface StopOptions {
     timeout: number;
+    remove: boolean;
     removeVolumes: boolean;
 }
 export interface DockerComposeDownOptions {
@@ -55,8 +58,13 @@ export interface StartedTestContainer {
     getNetworkNames(): string[];
     getNetworkId(networkName: string): string;
     getIpAddress(networkName: string): string;
-    exec(command: string[]): Promise<ExecResult>;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
+    copyFilesToContainer(filesToCopy: FileToCopy[]): Promise<void>;
+    copyContentToContainer(contentsToCopy: ContentToCopy[]): Promise<void>;
+    exec(command: string | string[]): Promise<ExecResult>;
     logs(): Promise<Readable>;
 }
 export interface StoppedTestContainer {
+    getId(): string;
+    copyArchiveFromContainer(path: string): Promise<NodeJS.ReadableStream>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "testcontainers",
   "author": "Cristian Greco",
-  "version": "9.8.0",
+  "version": "9.9.0",
   "main": "dist/src/index",
   "types": "dist/src/index",
   "keywords": [
@@ -43,13 +43,14 @@
     "async-lock": "^1.4.0",
     "byline": "^5.0.0",
     "debug": "^4.3.4",
-    "docker-compose": "^0.23.19",
+    "docker-compose": "^0.24.1",
     "dockerode": "^3.3.5",
     "get-port": "^5.1.1",
     "node-fetch": "^2.6.9",
     "properties-reader": "^2.2.0",
     "ssh-remote-port-forward": "^1.0.4",
-    "tar-fs": "^2.1.1"
+    "tar-fs": "^2.1.1",
+    "tmp": "^0.2.1"
   },
   "devDependencies": {
     "@elastic/elasticsearch": "^7.17.0",
@@ -61,7 +62,9 @@
     "@types/node-fetch": "^2.6.3",
     "@types/pg": "^8.6.6",
     "@types/properties-reader": "^2.1.1",
+    "@types/selenium-webdriver": "^4.1.14",
     "@types/tar-fs": "^2.0.1",
+    "@types/tmp": "^0.2.3",
     "@typescript-eslint/eslint-plugin": "^5.59.1",
     "@typescript-eslint/parser": "^5.59.1",
     "arangojs": "^8.2.1",
@@ -80,6 +83,7 @@
     "pg": "^8.10.0",
     "prettier": "^2.8.8",
     "rimraf": "^3.0.2",
+    "selenium-webdriver": "^4.9.2",
     "ts-jest": "^29.1.0",
     "ts-node": "^10.9.1",
     "typescript": "^4.9.5",