Test Bun compatibility in CI

Author: cristianrgreco

.github/workflows/checks.yml

@@ -146,25 +146,60 @@ jobs:
         env:
           DEBUG: "testcontainers*"
 
-  test:
+  test-docker:
     if: ${{ needs.detect-modules.outputs.modules_count != '0' }}
-    name: Tests
+    name: Tests (Docker)
     needs:
       - detect-modules
       - lint
       - compile
     strategy:
       fail-fast: false
-      max-parallel: 20
       matrix:
         module: ${{ fromJSON(needs.detect-modules.outputs.modules) }}
         node-version: [22.x, 24.x]
-        container-runtime: [docker, podman]
     uses: ./.github/workflows/test-template.yml
     with:
       runner: ubuntu-24.04
       node-version: ${{ matrix.node-version }}
-      container-runtime: ${{ matrix.container-runtime }}
+      container-runtime: docker
+      workspace: "${{ matrix.module }}"
+
+  test-podman:
+    if: ${{ needs.detect-modules.outputs.modules_count != '0' }}
+    name: Tests (Podman)
+    needs:
+      - detect-modules
+      - lint
+      - compile
+    strategy:
+      fail-fast: false
+      matrix:
+        module: ${{ fromJSON(needs.detect-modules.outputs.modules) }}
+        node-version: [22.x, 24.x]
+    uses: ./.github/workflows/test-template.yml
+    with:
+      runner: ubuntu-24.04
+      node-version: ${{ matrix.node-version }}
+      container-runtime: podman
+      workspace: "${{ matrix.module }}"
+
+  test-bun:
+    if: ${{ needs.detect-modules.outputs.modules_count != '0' }}
+    name: Tests (Bun)
+    needs:
+      - detect-modules
+      - lint
+      - compile
+    strategy:
+      fail-fast: false
+      matrix:
+        module: ${{ fromJSON(needs.detect-modules.outputs.modules) }}
+    uses: ./.github/workflows/test-template.yml
+    with:
+      runner: ubuntu-24.04
+      bun-version: 1.3.14
+      container-runtime: docker
       workspace: "${{ matrix.module }}"
 
   end:
@@ -175,7 +210,9 @@ jobs:
       - lint
       - compile
       - smoke-test
-      - test
+      - test-docker
+      - test-podman
+      - test-bun
     runs-on: ubuntu-24.04
     steps:
       - name: Check if any jobs failed

.github/workflows/test-template.yml

@@ -5,8 +5,13 @@ on:
         required: true
         type: string
       node-version:
-        required: true
+        required: false
+        type: string
+        default: 24.x
+      bun-version:
+        required: false
         type: string
+        default: ""
       container-runtime:
         required: true
         type: string
@@ -34,7 +39,23 @@ jobs:
           node-version: ${{ inputs.node-version }}
           workspace: "${{ inputs.workspace }}"
 
-      - name: Run tests
+      - name: Install Bun ${{ inputs.bun-version }}
+        if: ${{ inputs.bun-version != '' }}
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: ${{ inputs.bun-version }}
+
+      - name: Run tests with Node
+        if: ${{ inputs.bun-version == '' }}
         run: npm run test:ci -- --coverage.include="${{ steps.npm-install.outputs.workspace_path }}/**/*.ts" ${{ steps.npm-install.outputs.workspace_path }}
         env:
           CI: true
+
+      # Vitest's V8 coverage provider requires node:inspector coverage APIs that Bun does not support.
+      # https://github.com/oven-sh/bun/issues/4145
+      - name: Run tests with Bun
+        if: ${{ inputs.bun-version != '' }}
+        run: bun run --bun vitest run ${{ steps.npm-install.outputs.workspace_path }}
+        env:
+          CI: true
+          CI_BUN: true

packages/testcontainers/src/wait-strategies/http-wait-strategy.test.ts

@@ -161,13 +161,16 @@ describe("HttpWaitStrategy", { timeout: 180_000 }, () => {
       ).rejects.toThrow();
     });
 
-    it("allow self-signed certificates", async () => {
-      await using container = await new GenericContainer("cristianrgreco/testcontainer:1.1.14")
-        .withExposedPorts(8443)
-        .withWaitStrategy(Wait.forHttp("/hello-world", 8443).usingTls().allowInsecure())
-        .start();
+    // https://github.com/oven-sh/bun/issues/14498
+    if (!process.env.CI_BUN) {
+      it("allow self-signed certificates", async () => {
+        await using container = await new GenericContainer("cristianrgreco/testcontainer:1.1.14")
+          .withExposedPorts(8443)
+          .withWaitStrategy(Wait.forHttp("/hello-world", 8443).usingTls().allowInsecure())
+          .start();
 
-      await checkContainerIsHealthyTls(container);
-    });
+        await checkContainerIsHealthyTls(container);
+      });
+    }
   });
 });