Skip to content
Python
4.3 KB
Raw Blame
// @vitest-environment jsdom

import { act, cleanup, render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { afterEach, expect, it, vi } from "vitest";
import { SourceSnapshotStatus } from "./SourceSnapshotStatus";

afterEach(cleanup);
const confirmedAt = "2026-09-14T04:00:00.000Z";

it("labels the last full-source observation without inventing a source event time", () => {
  render(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt, stale: false }}
      onRefresh={vi.fn()}
    />,
  );
  const stamp = screen.getByText(/状态确认于/).querySelector("time");
  expect(stamp?.dateTime).toBe(confirmedAt);
  expect(screen.queryByText("状态待核对")).toBeNull();
});

it("retains the exact prior time in stale state and offers an explicit read-only refresh", async () => {
  const onRefresh = vi.fn().mockResolvedValue(undefined);
  render(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt, stale: true }}
      onRefresh={onRefresh}
    />,
  );
  expect(screen.getByText("状态待核对")).toBeTruthy();
  expect(screen.getByText(/上次确认/).querySelector("time")?.dateTime).toBe(
    confirmedAt,
  );
  await userEvent.click(screen.getByRole("button", { name: "刷新来源状态" }));
  expect(onRefresh).toHaveBeenCalledOnce();
  expect(screen.getByText("状态待核对")).toBeTruthy();
});

it.each([null, "not-a-time"])(
  "does not fabricate an observation for %s",
  (confirmedAt) => {
    render(
      <SourceSnapshotStatus
        snapshot={{ confirmedAt, stale: true }}
        onRefresh={vi.fn()}
      />,
    );
    expect(screen.getByText("尚无已确认状态")).toBeTruthy();
    expect(document.querySelector("time")).toBeNull();
  },
);

it("coalesces repeated refresh clicks and retains the error until a real new snapshot", async () => {
  let fail!: (reason: Error) => void;
  const onRefresh = vi.fn(
    () =>
      new Promise((_, reject) => {
        fail = reject;
      }),
  );
  const view = render(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt, stale: true }}
      onRefresh={onRefresh}
    />,
  );
  await userEvent.dblClick(
    screen.getByRole("button", { name: "刷新来源状态" }),
  );
  expect(onRefresh).toHaveBeenCalledOnce();
  expect(
    screen.getByRole<HTMLButtonElement>("button", { name: "刷新来源状态" })
      .disabled,
  ).toBe(true);
  await act(async () => fail(new Error("offline")));
  expect(screen.getByRole("alert").textContent).toContain("尚未取得新状态");
  expect(screen.getByText(/上次确认/).querySelector("time")?.dateTime).toBe(
    confirmedAt,
  );
  view.rerender(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt: "2026-09-14T04:01:00.000Z", stale: false }}
      onRefresh={onRefresh}
    />,
  );
  expect(screen.queryByRole("alert")).toBeNull();
  expect(screen.queryByText("状态待核对")).toBeNull();
});

it("reports a failed refresh even when the last snapshot was not stale", async () => {
  const onRefresh = vi.fn().mockRejectedValue(new Error("offline"));
  render(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt, stale: false }}
      onRefresh={onRefresh}
    />,
  );
  await userEvent.click(screen.getByRole("button", { name: "刷新来源状态" }));
  expect((await screen.findByRole("alert")).textContent).toContain(
    "刷新未成功,仍显示上次确认的状态。",
  );
  expect(screen.getByText(/状态确认于/).querySelector("time")?.dateTime).toBe(
    confirmedAt,
  );
  expect(screen.queryByText("尚无已确认状态")).toBeNull();
});

it("clears a failed refresh only after a newer authoritative snapshot arrives", async () => {
  const onRefresh = vi.fn().mockRejectedValue(new Error("offline"));
  const view = render(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt, stale: false }}
      onRefresh={onRefresh}
    />,
  );
  await userEvent.click(screen.getByRole("button", { name: "刷新来源状态" }));
  await screen.findByRole("alert");
  view.rerender(
    <SourceSnapshotStatus
      snapshot={{ confirmedAt: "2026-09-14T04:01:00.000Z", stale: false }}
      onRefresh={onRefresh}
    />,
  );
  expect(screen.queryByRole("alert")).toBeNull();
});

it("has no UI for legacy callers with no snapshot", () => {
  render(<SourceSnapshotStatus onRefresh={vi.fn()} />);
  expect(screen.queryByRole("button")).toBeNull();
});