Files
cc-1c-skills/.codeassistant/skills/web-test/scripts/engine/forms/click-group.mjs
T

42 lines
2.6 KiB
JavaScript

// web-test forms/click-group v1.1 — 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('<заголовок группы>', { expand: true }) — раскрыть (идемпотентно)
// clickElement('<заголовок группы>', { expand: false }) — свернуть (идемпотентно)
// clickElement('<заголовок группы>', { toggle: true }) — переключить
// clickElement('<заголовок группы>') — переключить (голый клик)
//
// target.collapsed приходит из findClickTargetScript (по display первого контент-сиблинга).
import { waitForStable } from '../core/wait.mjs';
import { modifierClick, returnFormState } from '../core/helpers.mjs';
import { shouldClickToggle } from '../table/grid-toggle.mjs';
export async function clickFormGroupTarget(target, ctx) {
const { formNum, modifier, toggle, expand } = ctx;
// shouldClickToggle ждёт { isExpanded }; при неизвестном состоянии (undefined) кликаем всегда.
const state = target.collapsed == null ? null : { isExpanded: !target.collapsed };
const shouldClick = shouldClickToggle(state, expand, toggle);
if (shouldClick) await modifierClick(target.x, 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.',
});
// Постусловие: клик, который ничего не переключил, — молчаливая ложь (то же правило, что
// guard на disabled в core/click.mjs). Проверяем ТОЛЬКО когда клик реально был сделан и
// состояние читаемо: при collapsed == null (нераспознанная вёрстка) сверять не с чем.
if (shouldClick && target.collapsed != null) {
const after = (result.groups || []).find(g => g.name === target.label);
if (after && after.collapsed === target.collapsed) {
throw new Error(`clickElement: group "${target.name}" did not toggle `
+ `(collapsed stayed ${after.collapsed})`);
}
}
return result;
}