Files
cc-1c-skills/.claude/skills/web-test/scripts/engine/forms/click-group.mjs
T
Nick ShirokovandClaude Opus 5 d0e81a1715 fix(web-test): состояние группы по контролу сворачивания, а не по вёрстке содержимого
На боевой форме вскрылись случаи, которые прежнее правило не покрывало. Замеры показали,
что любая эвристика «по первому сиблингу за заголовком» нежизнеспособна:

- служебная обёртка .logicGroupContainer пишется двумя способами (у таблицы
  <дочерний>#group_div, у вложенной группы <дочерний>_div) — знали только первый;
- display самой обёртки плавает: block до первого тогла, none после;
- первые узлы группы могут быть скрыты своей логикой, а видимое содержимое идёт дальше
  по цепочке — раскрытая группа читалась как свёрнутая, и постусловие роняло успешный клик.

Теперь состояние берётся из контрола сворачивания: у варианта «картинка» — кадр gx спрайта
hideshow у каретки (полярность обратна дереву в dom/grid.mjs), у варианта «гиперссылка»
каретки нет, там принадлежность по отступу — дети группы смещены глубже её заголовка,
свободный сосед стоит на уровне заголовка. База отсчёта — левый край блока заголовка
(каретка сдвигает текст вправо), обход ограничен: у последней свёрнутой группы границы за
ней нет, и первый видимый узел нашёлся через 107 сиблингов в чужой ветке формы.

Клик по заголовку группы теперь сперва скроллит цель в вид: цель кликается по координатам,
и ниже вьюпорта клик молча не доходил.

Ответ на клик отдаёт clicked.group (техническое имя) и clicked.title (текущий заголовок):
заголовок ключом быть не может — он повторяется между блоками формы и меняется при
раскрытии (CollapsedRepresentationTitle), после чего клик по прежнему тексту не находит
элемент. При смене заголовка hint говорит, чем кликать дальше.

Фикстура: вложенная группа первым ребёнком, «скрыт первый узел» в двух вариантах контрола,
группа с меняющимся заголовком в конце формы (уезжает за вьюпорт). Каждый кейс проверен на
красноту без своей правки.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-28 16:12:07 +03:00

67 lines
3.5 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// web-test forms/click-group v1.2 — click handler for collapsible/popup form-group titles.
// Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
//
// Reuses the tree/grid expand vocabulary so the model has ONE mental model:
// clickElement('<group title>', { expand: true }) — reveal (idempotent)
// clickElement('<group title>', { expand: false }) — hide (idempotent)
// clickElement('<group title>', { toggle: true }) — flip
// clickElement('<group title>') — flip (bare click)
//
// target.collapsed comes from findClickTargetScript (groupCollapsed in dom/_shared.mjs).
import { page } from '../core/state.mjs';
import { scrollGroupIntoViewScript } from '../../dom.mjs';
import { waitForStable } from '../core/wait.mjs';
import { modifierClick, returnFormState } from '../core/helpers.mjs';
import { shouldClickToggle } from '../table/grid-toggle.mjs';
// Group captions repeat across a form's blocks («Показать детализацию» in every block), and a
// collapsible group swaps its own caption when expanded (CollapsedRepresentationTitle:
// «Показать детализацию» ↔ «Скрыть детализацию»). Compare normalised so a real caption swap
// is not confused with nbsp/ё spelling differences.
const norm = (s) => (s || '').replace(/ /g, ' ').replace(/ё/gi, 'е').trim().toLowerCase();
export async function clickFormGroupTarget(target, ctx) {
const { formNum, modifier, toggle, expand } = ctx;
// shouldClickToggle expects { isExpanded }; with an unknown state (undefined) always click.
const state = target.collapsed == null ? null : { isExpanded: !target.collapsed };
const shouldClick = shouldClickToggle(state, expand, toggle);
if (shouldClick) {
// The target is clicked by coordinates, and on a long form those go stale or fall outside
// the viewport — the click then silently does nothing. Scroll the title into view and take
// a fresh point.
const pt = await page.evaluate(scrollGroupIntoViewScript(formNum, target.label));
await modifierClick(pt?.x ?? target.x, pt?.y ?? target.y, modifier);
}
await waitForStable(formNum);
const result = await returnFormState({
clicked: { kind: 'formGroup', name: target.name, toggled: shouldClick, ...(modifier ? { modifier } : {}) },
hint: shouldClick
? 'Group toggled. Call getFormState — its groups[].collapsed and revealed/hidden content update.'
: 'Group already in desired state.',
});
// The technical name is the stable key: it finds the entry in groups[] and clicks the same
// group again. The caption cannot do that — it changes when the group expands.
const after = (result.groups || []).find(g => g.name === target.label);
if (target.label) result.clicked.group = target.label;
if (after) {
result.clicked.title = after.title;
if (norm(after.title) !== norm(target.name)) {
result.hint += ` The group is now titled "${after.title}"`
+ ` — click it by that caption or by its technical name "${target.label}".`;
}
}
// Postcondition: a click that toggled nothing is a silent lie (same rule as the disabled
// guard in core/click.mjs). Checked ONLY when a click actually happened and the state is
// readable: with collapsed == null (unrecognised layout) there is nothing to compare against.
if (shouldClick && target.collapsed != null) {
if (after && after.collapsed === target.collapsed) {
throw new Error(`clickElement: group "${target.name}" did not toggle `
+ `(collapsed stayed ${after.collapsed})`);
}
}
return result;
}