레이아웃 편집기 spec 중 저장(PUT)까지 수행하는 것들이 제품 화면에 편집 결과를 영속시켜, 실행할 때마다 개발 사이트에 노드가 누적됐다(home 에 빈 표 7개, 관리자 대시보드에 빈 차트 5개). spec 안에 "추가한 노드 삭제 후 재저장" 원복을 넣어도 소용이 없었다 — 원복 후에도 레이아웃이 오염 시점과 정확히 같은 크기로 되돌아왔다. 원복에 기대는 대신 저장 대상 자체를 E2E 전용 시드 화면으로 분리한다. 시드 화면은 활성 템플릿 디렉토리에만 설치되므로 배포 원본과 릴리스 산출물은 변하지 않는다. globalSetup 이 매 실행 fixture 원본으로 덮어써 회차 간 누적이 성립하지 않으므로 저장 spec 에 원복 절차가 필요 없다. 설치는 레이아웃 파일과 라우트, DB 행 세 가지를 함께 다루되 시드 행만 건드린다 — 전체 재동기화를 쓰면 편집기로 저장한(파일에 없는) 변경이 실행할 때마다 사라지기 때문이다. 전수 실행에서 드러난 기존 실패도 함께 처리했다. 35건 중 27건은 절전·부하 아티팩트였고 나머지는 원인을 확정해 고쳤다. 템플릿 식별자 자리에 모듈 id 를 넣어 라우트 트리가 비어 있었고, "캔버스 텍스트가 길어진다"는 대리 지표가 렌더 여부와 무관했으며(정상 렌더에도 짧아진다), 팔레트 삽입 위치가 잠금 서브트리 안이면 선택이 조상으로 밀려 노드를 지목할 수 없었고, 상태 개수 단언이 상태 추가로 낡았고, if 게이트상 그 탭에 등록되지 않는 소스를 refetch 하고 있었고, 무통신 구간이 오지 않는 관리자 화면에 networkidle 을 기다렸고, 테스트 종료 후 도착한 route 콜백이 워커를 중단시켰고, 같은 설정 화면에 저장하는 테스트들이 병렬로 충돌했다. 측정 방법에서 반복해 틀린 지점들은 E2E 가이드에 표로 남겼다 — 가림은 가시성 판정으로 잡히지 않고, 길이 증감은 렌더 신호가 아니며, 총 개수 단언은 스펙이 늘면 깨지고, networkidle 은 실시간 연결이 있는 화면에서 오지 않는다.
119 lines
6.4 KiB
TypeScript
119 lines
6.4 KiB
TypeScript
/**
|
|
* Layout Editor — 잠긴 영역에서도 "요소 추가"(+) 버튼 노출 + 묶음 바깥 삽입.
|
|
*
|
|
* **배경**: 종전 컨텍스트 + 버튼은 선택 노드가 잠금(extension/extension_point/
|
|
* base/partial/data_bound)이면 전면 차단됐다(소유권 경계 우려). 그러나 "요소 추가"는
|
|
* 그 노드를 변형하는 게 아니라 **그 다음에(형제로) 또 다른 요소를 추가**하는 작업이라
|
|
* 안전하다는 판단으로 + 버튼을 복원했다.
|
|
*
|
|
* **잠금 종류별 anchor**:
|
|
* - extension/extension_point/base/partial: 잠긴 노드는 단일 박스로 렌더 → 그 노드
|
|
* 자신이 anchor. + 버튼은 그 박스 경계, 삽입은 부모(라우트 소유) children 형제.
|
|
* - data_bound 이터레이션: 인스턴스(`.iteration.N`)만 렌더되고 반복 정의 노드는 자체
|
|
* DOM 이 없다. anchor = 반복 정의 노드(selectedIterationSourcePath) → 삽입은 정의
|
|
* 노드의 형제(반복 묶음 **바깥**). 인스턴스 옆이 아님(가상 인덱스 회피).
|
|
*
|
|
* 신규 노드는 `__source` 미부여라 저장 마스킹(stripInheritedNodes)이 항상 route
|
|
* 콘텐츠로 보존한다.
|
|
*
|
|
* @scenario selected_node_state=extension_locked_selected,data_bound_selected
|
|
* @effects locked_node_shows_insertion_plus_via_anchor + insertion_inserts_outside_locked_group_as_sibling
|
|
*/
|
|
import type { Page } from '@playwright/test';
|
|
import { test, expect, issueToken, authenticatePage } from '../../fixtures/auth';
|
|
|
|
async function openRegisterEditor(page: Page): Promise<void> {
|
|
const token = issueToken('core.templates.layouts.edit');
|
|
await authenticatePage(page, token);
|
|
await page.goto('/admin/layout-editor/sirsoft-basic?route=%2Fregister');
|
|
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
|
// state 기본값은 'visible' 인데 프레임 하위 첫 노드는 빈 앵커(header_currency_inject_anchor)나
|
|
// `hidden` 클래스 요소일 수 있어 끝내 visible 이 되지 않는다 — 렌더 완료 판정은 존재로 한다.
|
|
await page.waitForSelector('[data-testid="g7le-preview-frame"] [data-editor-path]', {
|
|
state: 'attached',
|
|
timeout: 30_000,
|
|
});
|
|
}
|
|
|
|
async function openHomeEditor(page: Page): Promise<void> {
|
|
const token = issueToken('core.templates.layouts.edit');
|
|
await authenticatePage(page, token);
|
|
await page.goto('/admin/layout-editor/sirsoft-basic?route=%2F');
|
|
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
|
// state 기본값은 'visible' 인데 프레임 하위 첫 노드는 빈 앵커(header_currency_inject_anchor)나
|
|
// `hidden` 클래스 요소일 수 있어 끝내 visible 이 되지 않는다 — 렌더 완료 판정은 존재로 한다.
|
|
await page.waitForSelector('[data-testid="g7le-preview-frame"] [data-editor-path]', {
|
|
state: 'attached',
|
|
timeout: 30_000,
|
|
});
|
|
}
|
|
|
|
/** 합성 마우스 시퀀스로 노드 선택(드래그 핸들이 실제 click 을 가로채므로 dispatch). */
|
|
async function selectByText(page: Page, matcher: string, maxLen: number): Promise<Record<string, unknown>> {
|
|
return page.evaluate(
|
|
async ({ matcher, maxLen }) => {
|
|
const frame = document.querySelector('[data-testid="g7le-preview-frame"]')!;
|
|
const re = new RegExp(matcher);
|
|
// maxLen 제약을 반드시 함께 적용한다. textContent 는 자손 텍스트를 모두 포함하므로
|
|
// 길이 제한 없이는 화면 전체를 감싼 컨테이너가 먼저 걸려(진입점이 아니라 폼 전체) 선택
|
|
// 결과가 엉뚱해진다 — 실측에서 회원가입 폼 컨테이너가 잡혔다.
|
|
const cand = (Array.from(frame.querySelectorAll('[data-editor-path]')) as HTMLElement[])
|
|
.map((e) => ({ el: e, r: e.getBoundingClientRect() }))
|
|
.filter(
|
|
(x) =>
|
|
re.test(x.el.textContent || '') &&
|
|
(x.el.textContent || '').trim().length <= maxLen &&
|
|
x.r.width > 0 &&
|
|
x.r.height > 0,
|
|
);
|
|
const pick = cand[cand.length - 1];
|
|
if (!pick) return { found: false };
|
|
pick.el.scrollIntoView({ block: 'center' });
|
|
await new Promise((r) => setTimeout(r, 200));
|
|
const r = pick.el.getBoundingClientRect();
|
|
const cx = r.left + r.width / 2, cy = r.top + r.height / 2;
|
|
for (const t of ['pointerover', 'pointerenter', 'pointerdown', 'mousedown', 'pointerup', 'mouseup', 'click'])
|
|
pick.el.dispatchEvent(new MouseEvent(t, { bubbles: true, cancelable: true, clientX: cx, clientY: cy, view: window }));
|
|
await new Promise((r) => setTimeout(r, 500));
|
|
const sel = document.querySelector('[data-testid="g7le-overlay-selected"]');
|
|
const plus = (Array.from(document.querySelectorAll('[data-testid^="g7le-insertion-"]')) as HTMLButtonElement[])
|
|
.filter((b) => b.tagName === 'BUTTON')
|
|
.map((b) => {
|
|
const br = b.getBoundingClientRect();
|
|
return { disabled: b.getAttribute('data-disabled'), inView: br.width > 0 && br.top >= 0 && br.top < window.innerHeight };
|
|
});
|
|
return {
|
|
found: true,
|
|
lockKind: sel?.getAttribute('data-lock-kind') ?? null,
|
|
affordancesMounted: !!document.querySelector('[data-testid="g7le-insertion-affordances"]'),
|
|
enabledInViewCount: plus.filter((b) => b.disabled === 'false' && b.inView).length,
|
|
};
|
|
},
|
|
{ matcher, maxLen },
|
|
);
|
|
}
|
|
|
|
test.describe('@layout-editor 잠긴 영역 요소 추가(+) 복원', () => {
|
|
test('확장 주입 조각 선택 → 잠금이어도 + 버튼이 조각 박스 경계에 화면 내 노출', async ({ page }) => {
|
|
await openRegisterEditor(page);
|
|
const res = await selectByText(page, '마케팅 동의|광고성 이메일', 30);
|
|
|
|
expect(res.found).toBe(true);
|
|
expect(res.lockKind).toBe('extension');
|
|
expect(res.affordancesMounted).toBe(true);
|
|
// anchor=조각 박스라 + 버튼이 화면 안에 떠야 한다(이전 거대 박스 화면밖 회귀 차단).
|
|
expect(res.enabledInViewCount as number).toBeGreaterThan(0);
|
|
});
|
|
|
|
test('데이터 반복(인기글/최근글) 영역 선택 → data_bound 여도 + 버튼이 화면 내 노출', async ({ page }) => {
|
|
await openHomeEditor(page);
|
|
const res = await selectByText(page, '최근 게시글|샘플 게시글|게시글', 30);
|
|
|
|
expect(res.found).toBe(true);
|
|
if (res.lockKind === 'data_bound') {
|
|
expect(res.affordancesMounted).toBe(true);
|
|
expect(res.enabledInViewCount as number).toBeGreaterThan(0);
|
|
}
|
|
});
|
|
});
|