Normalize empty Podman health status

Author: cristianrgreco

packages/testcontainers/src/utils/map-inspect-result.test.ts

@@ -0,0 +1,36 @@
+import { ContainerInspectInfo } from "dockerode";
+import { mapInspectResult } from "./map-inspect-result";
+
+const inspectResult = (health?: { Status: string }): ContainerInspectInfo =>
+  ({
+    Name: "container",
+    Config: {
+      Hostname: "hostname",
+      Labels: {},
+    },
+    State: {
+      Status: "running",
+      Running: true,
+      StartedAt: "2026-05-14T10:00:00.000Z",
+      FinishedAt: "0001-01-01T00:00:00.000Z",
+      Health: health,
+    },
+    NetworkSettings: {
+      Ports: {},
+      Networks: {},
+    },
+  }) as unknown as ContainerInspectInfo;
+
+describe("mapInspectResult", () => {
+  it("should map missing health status to none", () => {
+    expect(mapInspectResult(inspectResult()).healthCheckStatus).toBe("none");
+  });
+
+  it("should map empty health status to none", () => {
+    expect(mapInspectResult(inspectResult({ Status: "" })).healthCheckStatus).toBe("none");
+  });
+
+  it("should map health status", () => {
+    expect(mapInspectResult(inspectResult({ Status: "healthy" })).healthCheckStatus).toBe("healthy");
+  });
+});

packages/testcontainers/src/utils/map-inspect-result.ts

@@ -39,7 +39,7 @@ function mapPorts(inspectInfo: ContainerInspectInfo): Ports {
 function mapHealthCheckStatus(inspectResult: ContainerInspectInfo): HealthCheckStatus {
   const health = inspectResult.State.Health;
 
-  if (health === undefined) {
+  if (health === undefined || health.Status === "") {
     return "none";
   } else {
     return health.Status as HealthCheckStatus;

packages/testcontainers/src/utils/test-helper.ts

@@ -29,7 +29,9 @@ export const checkContainerIsHealthy = async (container: StartedTestContainer):
 export const getHealthCheckStatus = async (container: StartedTestContainer): Promise<HealthCheckStatus | undefined> => {
   const client = await getContainerRuntimeClient();
   const dockerContainer = client.container.getById(container.getId());
-  return (await client.container.inspect(dockerContainer)).State.Health?.Status as HealthCheckStatus | undefined;
+  const status = (await client.container.inspect(dockerContainer)).State.Health?.Status;
+
+  return status === undefined || status === "" ? undefined : (status as HealthCheckStatus);
 };
 
 export const checkContainerIsHealthyTls = async (container: StartedTestContainer): Promise<void> => {