import fsSync from "node:fs"; import { describe, expect, it, vi } from "vitest"; import { getProcessStartTime, isPidAlive } from "./pid-alive.js"; function mockProcReads(entries: Record) { const originalReadFileSync = fsSync.readFileSync; vi.spyOn(fsSync, "readFileSync").mockImplementation((filePath, encoding) => { const key = String(filePath); if (Object.hasOwn(entries, key)) { return entries[key] as never; } return originalReadFileSync(filePath as never, encoding as never) as never; }); } async function withLinuxProcessPlatform(run: () => Promise): Promise { const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, "platform"); if (!originalPlatformDescriptor) { throw new Error("missing process.platform descriptor"); } Object.defineProperty(process, "platform", { ...originalPlatformDescriptor, value: "linux", }); try { vi.resetModules(); return await run(); } finally { Object.defineProperty(process, "platform", originalPlatformDescriptor); vi.restoreAllMocks(); } } describe("isPidAlive", () => { it("returns true for the current running process", () => { expect(isPidAlive(process.pid)).toBe(true); }); it("returns false for a non-existent PID", () => { expect(isPidAlive(2 ** 30)).toBe(false); }); it("returns false for invalid PIDs", () => { expect(isPidAlive(0)).toBe(false); expect(isPidAlive(-1)).toBe(false); expect(isPidAlive(1.5)).toBe(false); expect(isPidAlive(Number.NaN)).toBe(false); expect(isPidAlive(Number.POSITIVE_INFINITY)).toBe(false); }); it("returns false for zombie processes on Linux", async () => { const zombiePid = process.pid; mockProcReads({ [`/proc/${zombiePid}/status`]: `Name:\tnode\nUmask:\t0022\nState:\tZ (zombie)\nTgid:\t${zombiePid}\nPid:\t${zombiePid}\n`, }); await withLinuxProcessPlatform(async () => { const { isPidAlive: freshIsPidAlive } = await import("./pid-alive.js"); expect(freshIsPidAlive(zombiePid)).toBe(false); }); }); it("treats unreadable linux proc status as non-zombie when kill succeeds", async () => { const readFileSyncSpy = vi.spyOn(fsSync, "readFileSync").mockImplementation(() => { throw new Error("no proc status"); }); const killSpy = vi.spyOn(process, "kill").mockImplementation(() => true); await withLinuxProcessPlatform(async () => { const { isPidAlive: freshIsPidAlive } = await import("./pid-alive.js"); expect(freshIsPidAlive(42)).toBe(true); }); expect(readFileSyncSpy).toHaveBeenCalledWith("/proc/42/status", "utf8"); expect(killSpy).toHaveBeenCalledWith(42, 0); }); }); describe("getProcessStartTime", () => { it("returns a number on Linux for the current process", async () => { // Simulate a realistic /proc//stat line const fakeStat = `${process.pid} (node) S 1 ${process.pid} ${process.pid} 0 -1 4194304 12345 0 0 0 100 50 0 0 20 0 8 0 98765 123456789 5000 18446744073709551615 0 0 0 0 0 0 0 0 0 0 0 0 17 0 0 0 0 0 0`; mockProcReads({ [`/proc/${process.pid}/stat`]: fakeStat, }); await withLinuxProcessPlatform(async () => { const { getProcessStartTime: fresh } = await import("./pid-alive.js"); const starttime = fresh(process.pid); expect(starttime).toBe(98765); }); }); it("returns null on non-Linux platforms", () => { if (process.platform === "linux") { // On actual Linux, this test is trivially satisfied by the other tests. expect(true).toBe(true); return; } expect(getProcessStartTime(process.pid)).toBeNull(); }); it("returns null for invalid PIDs", () => { expect(getProcessStartTime(0)).toBeNull(); expect(getProcessStartTime(-1)).toBeNull(); expect(getProcessStartTime(1.5)).toBeNull(); expect(getProcessStartTime(Number.NaN)).toBeNull(); expect(getProcessStartTime(Number.POSITIVE_INFINITY)).toBeNull(); }); it("returns null for malformed /proc stat content", async () => { mockProcReads({ "/proc/42/stat": "42 node S malformed", }); await withLinuxProcessPlatform(async () => { const { getProcessStartTime: fresh } = await import("./pid-alive.js"); expect(fresh(42)).toBeNull(); }); }); it("handles comm fields containing spaces and parentheses", async () => { // comm field with spaces and nested parens: "(My App (v2))" const fakeStat = `42 (My App (v2)) S 1 42 42 0 -1 4194304 0 0 0 0 0 0 0 0 20 0 1 0 55555 0 0 0 0 0 0 0 0 0 0 0 0 0 17 0 0 0 0 0 0`; mockProcReads({ "/proc/42/stat": fakeStat, }); await withLinuxProcessPlatform(async () => { const { getProcessStartTime: fresh } = await import("./pid-alive.js"); expect(fresh(42)).toBe(55555); }); }); it("returns null for negative or non-integer start times", async () => { const fakeStatPrefix = "42 (node) S 1 42 42 0 -1 4194304 12345 0 0 0 100 50 0 0 20 0 8 0 "; const fakeStatSuffix = " 123456789 5000 18446744073709551615 0 0 0 0 0 0 0 0 0 0 0 0 17 0 0 0 0 0 0"; mockProcReads({ "/proc/42/stat": `${fakeStatPrefix}-1${fakeStatSuffix}`, "/proc/43/stat": `${fakeStatPrefix}1.5${fakeStatSuffix}`, }); await withLinuxProcessPlatform(async () => { const { getProcessStartTime: fresh } = await import("./pid-alive.js"); expect(fresh(42)).toBeNull(); expect(fresh(43)).toBeNull(); }); }); });