На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа. - Все экраны заводятся в таблице src/routes.tsx с обязательным родителем (null — только у главной и входа); App рисует <Route> только из неё. - BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана. Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) — шаг назад, нет — на родителя с replace. - Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом экране с родителем; список «корневых» экранов закреплён. - После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на отработанную форму; экраны входа уводят вошедшего на главную. - Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе: «Назад» из штрафа возвращает к списку штрафов. - ErrorBoundary вместо белого экрана при падении. - driver-pwa/CLAUDE.md — правило и чек-лист нового раздела. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
147 lines
7.4 KiB
TypeScript
147 lines
7.4 KiB
TypeScript
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
|
|
import { cleanup, render, screen } from "@testing-library/react";
|
|
import { MemoryRouter, useLocation } from "react-router-dom";
|
|
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
|
|
import App from "@/App";
|
|
import appSource from "@/App.tsx?raw";
|
|
import { ROUTES, findRoute, resolveParent } from "@/routes";
|
|
import { clearPairing, savePairing } from "@/lib/pairing";
|
|
import { useAuth } from "@/store/auth";
|
|
import { useStaff } from "@/store/staff";
|
|
|
|
/**
|
|
* Сторож правила «Назад на каждом экране» (задача 6385, см. CLAUDE.md).
|
|
*
|
|
* Ходит по ТОЙ ЖЕ таблице, из которой App рисует маршруты: новый экран попадает
|
|
* под проверку сам. Сеть при этом висит вечно — экраны застревают в загрузке, а
|
|
* именно в таких состояниях кнопку раньше и теряли (голый спиннер карточки
|
|
* штрафа, пустой онбординг).
|
|
*/
|
|
|
|
/** Единственные экраны без «Назад»: главная и вход. Новый экран сюда не
|
|
* добавляют — ему заводят родителя в routes.tsx. */
|
|
const ROOTS = ["/", "/login"];
|
|
|
|
/** Адрес-образец: параметры пути заменяем единицей (/fines/:fineId → /fines/1). */
|
|
const sample = (path: string) => path.replace(/:[^/]+/g, "1");
|
|
|
|
/** Исходники приложения, кроме тестов и App: <Route> там быть не должно. */
|
|
const sources = import.meta.glob<string>(["./**/*.tsx", "!./**/*.test.tsx", "!./App.tsx"], {
|
|
query: "?raw",
|
|
import: "default",
|
|
eager: true,
|
|
});
|
|
|
|
/** Комментарии упоминают <Route> словами — проверяем только код. */
|
|
function stripComments(src: string): string {
|
|
return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
|
|
}
|
|
|
|
function Where() {
|
|
return <p data-testid="where">{useLocation().pathname}</p>;
|
|
}
|
|
|
|
function renderAt(url: string) {
|
|
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
|
|
return render(
|
|
<QueryClientProvider client={qc}>
|
|
<MemoryRouter initialEntries={[url]}>
|
|
<Where />
|
|
<App />
|
|
</MemoryRouter>
|
|
</QueryClientProvider>
|
|
);
|
|
}
|
|
|
|
describe("«Назад» на каждом экране", () => {
|
|
beforeEach(() => {
|
|
// Любой запрос (ky ходит через глобальный fetch) не отвечает никогда.
|
|
vi.stubGlobal("fetch", vi.fn(() => new Promise<Response>(() => {})));
|
|
window.history.replaceState(null, "", "/");
|
|
// Пускаем всюду: водитель под просмотром сотрудника проходит и RequireAuth,
|
|
// и RequireStaff, и учебную оплату; сессия Telegram держит экран ожидания.
|
|
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Проверка" });
|
|
useStaff.getState().setStaff("s", "staff");
|
|
savePairing({ pair_session: "S", poll_secret: "P", confirm_code: "1234", deep_link: null });
|
|
});
|
|
afterEach(() => {
|
|
// Сначала размонтировать: иначе сброс входа ниже гонит смонтированный экран
|
|
// на /login мимо act().
|
|
cleanup();
|
|
vi.unstubAllGlobals();
|
|
useAuth.getState().clear();
|
|
useStaff.getState().clear();
|
|
clearPairing();
|
|
});
|
|
|
|
it.each(ROUTES.map((r) => [r.path, r] as const))("%s", (_path, r) => {
|
|
// Экраны входа пускают только того, кто ещё не вошёл.
|
|
if (r.guard === "guest") useAuth.getState().clear();
|
|
const url = sample(r.path);
|
|
renderAt(url);
|
|
// Проверяем сам экран, а не тот, куда увела охрана маршрута.
|
|
expect(screen.getByTestId("where").textContent).toBe(url);
|
|
const back = screen.queryAllByRole("button", { name: "Назад" });
|
|
// Ровно одна: две кнопки с одним именем и разным поведением путают.
|
|
expect(back).toHaveLength(r.parent === null ? 0 : 1);
|
|
});
|
|
|
|
it.each(ROUTES.filter((r) => r.guard === "guest").map((r) => r.path))(
|
|
"вошедшего %s уводит на главную",
|
|
(path) => {
|
|
// Так «Назад» после входа по ссылке не возвращает к отработавшему входу.
|
|
renderAt(path);
|
|
expect(screen.getByTestId("where").textContent).toBe("/");
|
|
}
|
|
);
|
|
|
|
it("родителя нет только у главной и входа", () => {
|
|
const roots = ROUTES.filter((r) => r.parent === null).map((r) => r.path);
|
|
expect(roots.sort()).toEqual([...ROOTS].sort());
|
|
});
|
|
|
|
it("адрес находит свой же экран, а родитель — другой существующий", () => {
|
|
for (const r of ROUTES) {
|
|
const hit = findRoute(sample(r.path));
|
|
// BackBar должен взять тот же экран, что нарисовал <Routes>.
|
|
expect(hit?.route, r.path).toBe(r);
|
|
if (r.parent === null) continue;
|
|
for (const signedIn of [true, false]) {
|
|
const to = resolveParent(r.parent, { params: hit!.params, search: new URLSearchParams(), signedIn });
|
|
const target = findRoute(to.split("?")[0]);
|
|
// Опечатка в родителе или родитель-сам-себе: с холодного старта «Назад»
|
|
// заменил бы экран им же — кнопка есть, а уйти нельзя.
|
|
expect(target, `${r.path} → ${to}`).not.toBeNull();
|
|
expect(target!.route, `${r.path} → ${to}`).not.toBe(r);
|
|
}
|
|
}
|
|
});
|
|
|
|
it("родитель может зависеть от входа: вход сотрудника ведёт туда, откуда пришли", () => {
|
|
const hit = findRoute("/dev");
|
|
expect(hit).not.toBeNull();
|
|
const ctx = { params: hit!.params, search: new URLSearchParams() };
|
|
// Уже вошёл водителем (долгий тап с главной) — на главную; нет — ко входу.
|
|
expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: true })).toBe("/");
|
|
expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: false })).toBe("/login");
|
|
});
|
|
|
|
it("App рисует экраны только из таблицы маршрутов", () => {
|
|
// <Route>, вписанный в App мимо таблицы, остался бы без «Назад» и без
|
|
// проверки выше. Разрешены только ROUTES.map и перехват неизвестных адресов.
|
|
const code = stripComments(appSource);
|
|
expect(code.match(/<Route\s/g)).toHaveLength(2);
|
|
expect(code).toContain("<Route key={r.path} path={r.path}");
|
|
expect(code).toContain('<Route path="*"');
|
|
});
|
|
|
|
it("вложенных <Routes> в страницах и компонентах нет", () => {
|
|
// Экран, заведённый внутри страницы, тоже прошёл бы мимо таблицы.
|
|
const nested = Object.entries(sources)
|
|
.filter(([, src]) => /<Routes?[\s>/]/.test(stripComments(src)))
|
|
.map(([file]) => file);
|
|
expect(Object.keys(sources).length).toBeGreaterThan(10);
|
|
expect(nested).toEqual([]);
|
|
});
|
|
});
|