Дмитрий
0af5c5696f
РАЗМЕТКА ДОКУМЕНТАЦИИ. Проверка сторожа давала 237 замечаний в 21 файле — стало
0 во всех файлах под учётом git. Пустые строки вокруг списков и заголовков
поправлены автоматом в 12 файлах, два файла пришлось делать руками, потому что
автоправка там навредила:
- в описании починки инцидента номера шагов 1…7 — это ИМЕНА, на них ссылается
сам текст «из шага 2»; автоправка перенумеровала их в 1,1,1,1,2 и сломала
ссылки. Вывел ровно этот файл из-под одного правила, объяснение — в самом
файле, остальные правила действуют.
- в протоколе архитектуры автоправка склеила «R-* / DR-*» в «R-*/ DR-*».
Вместо этого обозначения взяты в обратные кавычки — смысл сохранён.
Семь файлов не тронуты: они вне учёта git — два в папке второй смены и старые
черновики в корне.
ИНТЕРФЕЙС. «Неизвестный тип» убран целиком: было 123 замечания, стало 0.
- Навигация автоподбора описана ОДИН раз — app/resources/js/views/autopodbor/nav.ts.
Раньше девять экранов повторяли описание с «неизвестным типом», а ещё три
описывали его каждый по-своему и не полностью.
- Чтение ошибки от сервера собрано в один помощник — app/resources/js/api/errors.ts,
с проверками. Он намеренно читает ФОРМУ ответа, а не полагается на axios:
тесты экранов подсовывают ошибку простым объектом той же формы, и экран обязан
вести себя в тестах так же, как в бою.
- В тестах вместо «неизвестного типа» — именованный доступ exposed<T> и полные
заготовки: app/tests/Frontend/support/. Каждый тест теперь объявляет ровно те
поля, до которых дотягивается, и опечатка в имени снова становится ошибкой,
а не молчаливым undefined. Заодно сняты 14 построчных отключений правила.
- Разведены задвоенные имена в шаблонах: в таблице сделок в одном шаблоне жили
ДВЕ разные функции isSelected — одна берёт номер сделки, другая строку таблицы.
- Убрана мёртвая функция dirLabel и три неиспользуемые переменные.
ПРОВЕРКА ТИПОВ: было 7 ошибок, стало 5. Две унаследованные закрылись попутно —
более строгие заготовки вскрыли нехватку обязательного поля elements. Оставшиеся
пять были до меня и не в моих строках.
ПРИЁМКА. Разметка проверена вырезанием: подложил поломку обратно — сторож её
поймал, вернул — снова чисто. Полный набор тестов интерфейса: 233 файла,
1750 тестов, 3 пропущено, 0 падений. Рабочий код на PHP не тронут.
NB: LEFTHOOK_EXCLUDE=cspell — тем же приёмом и по той же причине, что и в записи
e0223de4, которой эти шесть файлов исследования заводились в репозиторий: сырой
внешний материал с чужой терминологией. Замерено: до моих правок сторож
орфографии находил в них ровно столько же слов, сколько после — я не добавил
ни одного. Разметка в этих файлах теперь проходит начисто, отключена ТОЛЬКО
орфография и только на эту запись; остальные семнадцать сторожей отработали.
Решение владельца, спрошено отдельно.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
50 lines
2.7 KiB
TypeScript
50 lines
2.7 KiB
TypeScript
import { describe, it, expect } from 'vitest';
|
|
import { AxiosError } from 'axios';
|
|
import { apiErrorBody, apiErrorCode, apiFieldError } from '../../resources/js/api/errors';
|
|
|
|
function axErr(status: number, body: unknown): AxiosError {
|
|
const e = new AxiosError('err');
|
|
// @ts-expect-error — минимальный мок ответа
|
|
e.response = { status, data: body, statusText: '', headers: {}, config: {} };
|
|
return e;
|
|
}
|
|
|
|
describe('чтение ошибки от бэкенда — работает и на настоящей ошибке axios, и на её форме', () => {
|
|
it('код ошибки читается из настоящей ошибки axios', () => {
|
|
expect(apiErrorCode(axErr(409, { error: 'balance_insufficient' }))).toBe('balance_insufficient');
|
|
});
|
|
|
|
it('код ошибки читается из простого объекта той же формы', () => {
|
|
// Так ошибку подсовывают тесты экранов: mockRejectedValue({ response: { data: { error: ... } } }).
|
|
// Поведение обязано совпадать с настоящей ошибкой — иначе экран ведёт себя в тестах
|
|
// не так, как в бою.
|
|
expect(apiErrorCode({ response: { data: { error: 'run_in_flight' } } })).toBe('run_in_flight');
|
|
});
|
|
|
|
it('ошибка поля читается по имени поля', () => {
|
|
const e = axErr(422, { errors: { name: ['Название занято.'], site: ['Плохой сайт.'] } });
|
|
expect(apiFieldError(e, 'name')).toBe('Название занято.');
|
|
expect(apiFieldError(e, 'site')).toBe('Плохой сайт.');
|
|
});
|
|
|
|
it('нет такого поля — undefined, а не падение', () => {
|
|
expect(apiFieldError(axErr(422, { errors: { name: ['занято'] } }), 'site')).toBeUndefined();
|
|
});
|
|
|
|
it('тело ошибки отдаётся целиком, когда оно есть', () => {
|
|
expect(apiErrorBody(axErr(422, { message: 'Так нельзя.' }))).toEqual({ message: 'Так нельзя.' });
|
|
});
|
|
|
|
it('обычная ошибка без ответа сервера — undefined во всех трёх случаях', () => {
|
|
expect(apiErrorBody(new Error('x'))).toBeUndefined();
|
|
expect(apiErrorCode(new Error('x'))).toBeUndefined();
|
|
expect(apiFieldError(new Error('x'), 'name')).toBeUndefined();
|
|
});
|
|
|
|
it('мусор вместо ошибки не роняет чтение', () => {
|
|
for (const junk of [null, undefined, 0, '', 'строка', { response: null }, { response: { data: 7 } }]) {
|
|
expect(apiErrorCode(junk)).toBeUndefined();
|
|
}
|
|
});
|
|
});
|