WooCommerce Product Add-ons의 추가 항목(애드온) 순서를 Playwright를 사용하여 자동적으로 정렬해야 할 필요가 있었습니다. 처음에는 jQuery UI sortable의 드래그&드롭을 그대로 재현하려고 시도했지만, 잡는 좌표나 이동량이 몇 픽셀만 어긋나도 순서가 바뀌지 않았고, 대기 시간(wait time)을 늘려도 불안정했습니다.
결론부터 말씀드리자면, 드래그를 재현할 필요가 없었습니다. 저장 시점에 '무엇이 순서를 결정하는지'를 관리 화면의 JavaScript 코드를 통해 확인한 결과, 정렬 완료 시 각 행의 .wc-pao-addon-position 값을 DOM 순서에 맞춰 다시 지정해주는 것뿐이었습니다. 즉, 드래그는 단순히 '번호를 재지정할 계기(trigger)'일 뿐이며, 본질은 DOM 순서와 position 값입니다. 이후에는 DOM을 목적 순서대로 appendChild하여 position을 0부터 다시 지정하는 방식으로 변경했고, 안정적으로 통과했습니다.
- WordPress 6.6 / WooCommerce 8.9
- WooCommerce Product Add-ons 6.x (클래스명은 도입 버전에 따라 달라지므로, 실제 DOM은 DevTools로 확인해 주세요)
- Playwright 1.45 (TypeScript / Node.js 20)
- 실행 브라우저: Chromium (headless, CI는 GitHub Actions의 ubuntu-latest)
- 인증: 관리자 로그인 완료된 storageState 재사용
jQuery UI sortable은 mousedown → mousemove (여러 번) → mouseup 시퀀스와 이동량 임계값(distance / tolerance)을 이용해 정렬 판정을 합니다. Playwright의 dragTo()는 내부적으로 몇 번의 mousemove만 발생시키기 때문에, 임계값 판정에 걸리지 않아 '잡았지만 움직이지 않은' 상태가 되기 쉽습니다.
mouse.move를 steps와 함께 간격(interval)을 두고 실행하고, boundingBox()의 중심을 잡은 뒤, 이동할 위치를 절반만큼 어긋나게 하는 등의 조정을 시도했지만, 행의 높이가 가변적(텍스트 영역을 포함하는 행이 있음)이라 환경이나 화면 너비에 따라 1~2px씩 어긋나 실패했습니다. waitForTimeout을 늘리는 것은 '언젠가 통과할 것'이라는 느낌만 줄 뿐, 근본적인 해결책은 아닙니다.
관리 화면의 JavaScript (admin/assets/js/*.js를 정리하여 확인)에서는 sortable의 stop 이벤트 후에 다음과 같은 처리가 실행되고 있었습니다(요약).
$('.wc-pao-addon').each(function (index) {
$(this).find('.wc-pao-addon-position').val(index);
...
position은 0부터 시작하는 연속 번호이며, 저장 시 이 값이 서버로 전송됩니다. 즉, 순서의 정답은 'DOM 순서에 맞춰 재지정된 position'이며, 드래그는 그저 트리거에 불과합니다. 그렇다면 좌표를 맞출 필요가 없습니다.
- 편집 화면을 열고, 애드온 행이 예상 개수만큼 있는지
expect로 확인한다 -
- 각 행의 식별자(라벨명 등) → 요소의 Map을 생성한다
- 목적의 순서대로 DOM 순서를 확정시킨다 (
appendChild)
- position을 0부터 다시 지정하고,
change 이벤트를 발생시킨다 - 저장 (#publish와 유사) → networkidle을 기다린다 - ①편집 화면의 순서 ②공개 측의 순서 ③저장 전후 모든 항목 차이점 세 군데에서 대조한다
import { Page, expect } from '@playwright/test';
const CONTAINER = '#wc-pao-addons';
const ROW_SELECTOR = '#wc-pao-addons .wc-pao-addon';
...
const before = await snapshotAllFields(page);
await reorderAddons(page, ['사이즈', '각인', '포장']);
await page.click('#publish');
...
③을 넣지 않으면, appendChild의 부작용으로 의도하지 않은 필드까지 덮어쓰여도 알아차리기 어렵습니다. 실제로 행 이동 시 name 속성의 연속 번호(예: addon_0, addon_1...)가 어긋나는 구현이라면, 여기서 감지할 수 있습니다.
| 관점 | 드래그 재현 (Drag Reproduction) | DOM 정렬 + position 재설정 (DOM Sorting + Position Reset) |
|---|
| 안정성 | 좌표・행 높이・화면 너비에 의존하여 불안정함(flaky) | 좌표가 필요 없어 안정적임 |
| ... | | |
- |
position 시작 값: 0부터 시작인지 1부터 시작인지는 구현에 따라 다릅니다. 반드시 저장 처리 측 코드에서 확인해야 합니다. -
: change 이벤트 발생 시, input.value를 직접 덮어쓰기만 해서는 jQuery 측의 상태가 업데이트되지 않을 수 있습니다. dispatchEvent나 $(el).trigger('change')를 병용하는 것이 좋습니다.
템플릿 행 혼입: 비활성화된 템플릿 행이 DOM에 남아있는 경우가 있습니다. :visible이나 클래스로 제외하지 않으면 개수가 맞지 않습니다. -
: 이벤트 리스너는 요소에 연결되므로 기본적으로 유지되지만, jQuery UI의 내부 상태는 손상됩니다. 저장으로 이동만 하는 것이라면 실질적인 피해는 없습니다.
appendChild의 부작용 - |
공개 측 캐시: 저장 직후 공개 페이지가 오래된 순서를 반환하는 경우가 있습니다. 캐시 플러그인 도입 환경에서는 퍼지(purge)나 캐시 바스트(cache bust)를 적용해야 합니다.
Q. 드래그 기능을 포기하는 것이 테스트로서 너무 안일한 결정 아닌가요?
A. 정렬 순서의 사양은 '저장 후의 순서'입니다. UI 조작 경로는 수동 확인 1회와 스모크 테스트로 보장하고, E2E는 결과 검증에 중점을 두는 것이 비용 대비 효과가 높다고 판단했습니다.
Q. jQuery UI sortable을 어떻게든 안정화시키고 싶습니다.
A. mouse.move를 steps: 10 이상으로 간격 설정하고, 잡는 위치를 boundingBox의 중심점으로 삼으며, stop 이벤트를 waitForFunction으로 기다리는 세 가지 지점을 개선하면 어느 정도 향상됩니다. 하지만 본질적으로 좌표에 의존하므로 불안정함(flaky)은 남아있습니다.
Q. position을 재설정하는 것만으로 정말 저장되나요?
A. 저장 처리 로직이 position 값을 보고 있다는 것을 코드로 확인했다면 성립합니다. 확인하지 않고 추측에 의존하여 덮어쓰는 것은 위험합니다.
자동 조작이 불안정할 때는, 조작을 재현하기 전에 '저장 처리가 무엇을 보고 순서를 결정하고 있는지'를 먼저 읽어야 합니다. 이것이 이번 판단 규칙입니다. UI의 시각적인 모습에 끌리면 드래그 기능을 재현하고 싶어지지만, 애플리케이션의 진실은 대부분 DOM 구조와 숨겨진 필드의 값입니다. 그 부분을 직접 조작하여 저장 전후의 차이(diff)로 보장하는 것이 E2E 테스트를 더 짧고, 빠르고, 안정적으로 만듭니다.
BENTEN Web Works — 업무 자동화・시스템 개발 프리랜서 엔지니어입니다.
GAS / Python / RPA를 사용한 업무 자동화 및 웹 제작・시스템 개발 상담을 받고 있습니다.
'이런 것도 자동화할 수 있을까?'라는 질문만으로도 편하게 문의해 주세요.
👉 업무 자동화 서비스 — 상세/문의는 여기를 클릭하세요
🐦 X (구 Twitter) — 일일 지식을 발신 중