Files
diegosouzapw--omniroute/tests/unit/docker-healthcheck-3151.test.ts
2026-07-13 13:39:12 +08:00

95 lines
3.1 KiB
TypeScript

import test from "node:test";
import assert from "node:assert/strict";
import http from "node:http";
// #3151 — Docker healthcheck always reports unhealthy because the probe only
// hit 127.0.0.1 and swallowed every error (empty Output, undiagnosable).
// The hardened script exports an injectable `probeHealth` helper that tries an
// ordered host list and surfaces the last error on total failure.
const { probeHealth } = (await import("../../scripts/dev/healthcheck.mjs")) as {
probeHealth: (opts: {
port: number | string;
hosts?: string[];
fetchImpl?: typeof fetch;
timeoutMs?: number;
}) => Promise<string>;
};
/** Start an ephemeral HTTP server bound only to the given host. */
function startServer(host: string): Promise<{ server: http.Server; port: number }> {
return new Promise((resolve, reject) => {
const server = http.createServer((req, res) => {
if (req.url === "/api/monitoring/health") {
res.writeHead(200, { "content-type": "application/json" });
res.end(JSON.stringify({ status: "ok" }));
} else {
res.writeHead(404);
res.end();
}
});
server.on("error", reject);
server.listen(0, host, () => {
const addr = server.address();
if (addr && typeof addr === "object") {
resolve({ server, port: addr.port });
} else {
reject(new Error("no address"));
}
});
});
}
function closeServer(server: http.Server): Promise<void> {
return new Promise((resolve) => server.close(() => resolve()));
}
const servers: http.Server[] = [];
test.after(async () => {
for (const s of servers) {
await closeServer(s);
}
});
test("probeHealth resolves the host when the server is on 127.0.0.1", async () => {
const { server, port } = await startServer("127.0.0.1");
servers.push(server);
const ok = await probeHealth({ port, hosts: ["127.0.0.1", "localhost", "::1"] });
assert.equal(ok, "127.0.0.1");
});
test("probeHealth falls through to a later host when 127.0.0.1 is unreachable", async () => {
// Bind the real server on 127.0.0.1, but list an unreachable host first so
// the helper must fall through. We point the first host at a port with no
// listener to simulate ECONNREFUSED, then the real host on the same port.
const { server, port } = await startServer("127.0.0.1");
servers.push(server);
// First host resolves to nothing listening (use a host alias that will fail),
// second host is the working loopback.
const ok = await probeHealth({
port,
hosts: ["192.0.2.1", "127.0.0.1"], // 192.0.2.1 = TEST-NET-1, unroutable
timeoutMs: 300,
});
assert.equal(ok, "127.0.0.1");
});
test("probeHealth throws a non-empty error string when every host fails", async () => {
// No server started: pick a port unlikely to have a listener.
await assert.rejects(
() =>
probeHealth({
port: 1, // privileged/closed port → connection refused
hosts: ["127.0.0.1", "localhost"],
timeoutMs: 300,
}),
(err: unknown) => {
assert.ok(err instanceof Error);
assert.ok(err.message.length > 0, "error message must be non-empty (not swallowed)");
return true;
}
);
});