--- url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/development/testing' title: '테스트 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T01:40:46+00:00' updated: '2026-10-24T09:09:48+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- DXPR Builder에는 네 가지 자동 검사가 있습니다. 편집기의 Puppeteer 테스트, Drush 명령용 Bash 종단 간 테스트, 별도 dxpr_maven 저장소의 Selenium 시각 회귀 스위트, 린터. 이 페이지에서는 각각의 내용, 로컬 실행법, CI 실행법을 나열합니다. tags: - Tooling image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T09:09:48+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 테스트 description: |- DXPR Builder에는 네 가지 자동 검사가 있습니다. 편집기의 Puppeteer 테스트, Drush 명령용 Bash 종단 간 테스트, 별도 dxpr_maven 저장소의 Selenium 시각 회귀 스위트, 린터. 이 페이지에서는 각각의 내용, 로컬 실행법, CI 실행법을 나열합니다. image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T01:40:46+0000' dateModified: '2026-10-24T09:09:48+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/development/testing' articleSection: Tooling - '@type': WebPage '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/development/testing' description: |- DXPR Builder에는 네 가지 자동 검사가 있습니다. 편집기의 Puppeteer 테스트, Drush 명령용 Bash 종단 간 테스트, 별도 dxpr_maven 저장소의 Selenium 시각 회귀 스위트, 린터. 이 페이지에서는 각각의 내용, 로컬 실행법, CI 실행법을 나열합니다. breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 홈 item: 'https://dxpr.com/ko' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: ko --- [Help Center](/ko/node/75)/[Documentation](/ko/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Extend](/hc/documentation/learn-dxpr-builder/extend) /[Tooling](/hc/documentation/learn-dxpr-builder/extend/tooling) # 테스트. Learn DXPR BuilderExtendTooling ## In this guide Related guides - [기여하기](/ko/hc/documentation/learn-dxpr-builder/development/contributing) - [Drush 명령](/ko/hc/documentation/learn-dxpr-builder/development/drush-commands) DXPR Builder에는 네 가지 자동 검사가 있습니다. 편집기의 Puppeteer 테스트, Drush 명령용 Bash 종단 간 테스트, 별도 `dxpr_maven` 저장소의 Selenium 시각 회귀 스위트, 린터. 이 페이지에서는 각각의 내용, 로컬 실행법, CI 실행법을 나열합니다. ## 검사 목록 | 검사 | 위치 | 실행 조건 | |---|---|---| | 편집기 콘솔 및 레이아웃 테스트 | `test/test-editor.js` | JavaScript, HTML, `test/`를 건드리는 풀 리퀘스트(`.github/workflows/fe-test.yaml`) | | Drush 종단 간 테스트 | `scripts/drush-e2e/` | PHP, YAML, Markdown을 건드리는 풀 리퀘스트(`.github/workflows/review.yaml`) | | Selenium 시각 회귀 스위트 | `dxpr_maven` 저장소 | PR 댓글 명령(`.github/workflows/e2e-command.yaml`, `e2e-bs3-command.yml`, `e2eV2-command.yaml`) | | PHP 코딩 표준(phpcs) | `scripts/linters/run-drupal-lint.sh`, `phpcs.xml.dist` | PHP, YAML, Markdown을 건드리는 풀 리퀘스트. 푸시 대상: `3.x` | | PHPStan | `scripts/linters/run-drupal-check.sh` | PHP, YAML, Markdown을 건드리는 풀 리퀘스트. 푸시 대상: `3.x` | | ESLint, Stylelint, Rust Clippy | `scripts/linters/` | 풀 리퀘스트. 바뀐 경로로 필터링. | | 지원 중단 감지기 | `.github/workflows/deprecations.yml` | 다음을 건드리는 풀 리퀘스트: `js/`나 `dxpr_builder/build/` | | 문서 검사(markdownlint, `check_docs.py`, Vale) | `.markdownlint-cli2.yaml`, `docs/lint/`, `.vale.ini` | 다음을 건드리는 풀 리퀘스트: `docs/`(`review.yaml`) | 저장소의 유일한 PHPUnit 테스트는 기존 미디어 하위 모듈용 `modules/dxpr_builder_media/tests/src/FunctionalJavascript/MediaEntityBrowserTest.php`입니다. GitHub 워크플로는 실행하지 않습니다. drupal.org GitLab 파이프라인(`.gitlab-ci.yml`)은 표준 DrupalCI 템플릿을 쓰며, 그곳의 PHPUnit 작업은 꺼져 있지 않습니다. ## 편집기 콘솔 테스트 `test/test-editor.js`(은)는 포트 3000에 정적 서버를 시작하고 (`test/start-standalone-server.js`) 헤드리스 Chrome에서 `test/standalone-editor/`의 독립 페이지 네 개를 엽니다. `test-bs5-anon.html`, `test-bs5-cms-block.html`, `test-bs5-editor.html`, `test-bs5-clean-html.html`. 다음 경우 실패합니다. - 페이지에서 JavaScript 오류 발생. - 전체 편집기가 2000ms 안에 준비되지 않거나 로드 후 지연된 화면 밖 제어 장치가 없을 때(성능 게이트). - 파워 사용자 모드에서 요소 제어 장치가 겹칠 때(기준선은 겹치는 쌍 0개). - 전체 편집기 페이지의 저장된 HTML이 기준인 32,094자보다 클 때. - 페이지별 검사가 실패할 때. 예: 깨끗한 Bootstrap HTML 파싱, 브레드크럼, Panel 유형, 로컬 비디오의 **Muted** 설정, CMS 블록 미리 보기. 페이지는 `dxpr_builder/`의 빌드된 파일을 불러오므로 먼저 빌드하세요. 1. 의존성을 설치하세요: ```bash npm install ``` 2. 편집기 번들을 빌드하세요. CI 스크립트는 다음 순서로 작업을 실행합니다(`test/scripts/run-fe-tests.sh`). ```bash npx grunt concat npx grunt exec:gen npx grunt babel npx grunt terser npx grunt sass npx grunt postcss ``` 3. 테스트를 실행하세요: ```bash npm run fe-test ``` 브라우저를 보려면 `npm run fe-test:headed`(을)를, 어서션 없이 독립 페이지를 서빙하려면 `npm run fe-test:dev`(을)를 쓰세요. CI에서는 `.github/workflows/fe-test.yaml`(이)가 같은 테스트를 Docker로 실행합니다: ```bash docker compose --profile fe-test run --rm fe-test ``` ## Drush 종단 간 테스트 `scripts/drush-e2e/run-e2e-tests.sh`(은)는 Composer 컨테이너 안에 SQLite로 새 Drupal 11 사이트를 설치하고, 모듈을 심볼릭 링크로 넣고, 활성화하고, `dxpr_builder_text`포매터의 Basic page 콘텐츠 유형, 페이지 템플릿, 사용자 템플릿을 만든 뒤 모든 `scripts/drush-e2e/test-*.sh` 파일을 실행합니다: | 파일 | 테스트 대상 명령 | |---|---| | `test-cleartext-key-update.sh` | 업데이트 9026은 Key 모듈 저장소에 남은 평문 제품 키를 지우고, 고른 Key가 사라지면 유지합니다(`cleartext-key-update.php`). | | `test-cms-cache-tags.sh` | 블록 및 뷰 목록의 캐시 무효화(`cms-cache-tags.php`). | | `test-elements.sh` | `drush dxb:element:list` | | `test-migration-summary.sh` | 마이그레이션 열 요약의 단복수 표현(`migration-summary.php`). | | `test-migrations.sh` | `drush dxb:migrate`와 콘텐츠 마이그레이션 회귀(`migration-regressions.php`). | | `test-page-controller.sh` | 경로용 페이지 컨트롤러 빌드(`page-controller.php`). | | `test-page-create.sh` | `drush dxb:page:create` | | `test-page-get-update.sh` | `drush dxb:page:get`, `drush dxb:page:update` | | `test-page-module.sh` | Drag and Drop Page 모듈은 나열한 모든 구성을 포함(`page-module.php`). | | `test-profile-buttons.sh` | 빌더 프로필의 텍스트 편집기 버튼(`profile-buttons.php`). | | `test-profile-order.sh` | 가중치로 적용되는 프로필과 프로필 목록 순서(`profile-order.php`). | | `test-settings-form.sh` | 다음 작업과 그에 따른 라이선스 동기화: **General Settings**에서의 제품 키 저장 및 검증(`settings-form.php`). | | `test-setup-ai.sh` | `drush dxb:setup-ai` | | `test-templates.sh` | `drush dxb:template:list` | | `test-user-licenses-page.sh` | 라이선스 카드가 **User Licenses**에 한 번 표시되고 **People**에도 계속 표시됨(`user-licenses-page.php`). | | `test-user-settings.sh` | 각 편집자의 편집기 설정(`user-settings.php`). | | `test-user-templates.sh` | `drush dxb:user-template:list`, `drush dxb:user-template:create` | 전부 실행: ```bash docker compose --profile drush-e2e run --rm e2e-test ``` 이름 일부를 전달해 하나의 파일을 실행하세요. 스크립트는 다음에 대조합니다: `scripts/drush-e2e/test-**.sh`. ```bash docker compose --profile drush-e2e run --rm e2e-test page-create ``` 테스트를 추가하려면 다음을 만들고: `scripts/drush-e2e/test-.sh`. 다음을 호출하고: `section ""`. 다음의 도우미를 쓰세요: `scripts/drush-e2e/_helpers.sh`. `assert_success`, `assert_fail`, `assert_eq`, `assert_has`, `assert_not_empty`, `assert_runs`, `assert_dry_run`. 각 도우미는 설명과 명령 문자열을 받습니다. CI에서 이 스위트는 다음의 "Run Drush E2E tests" 작업입니다: `.github/workflows/review.yaml`. 풀 리퀘스트가 다음을 바꿀 때 실행됩니다: `.php`, `.module`, `.inc`, `.install`, `.yml`, `.md`, `composer.json`, `composer.lock` 파일. ## Selenium 시각 회귀 스위트 브라우저 테스트는 `dxpr_maven`저장소의 Java TestNG 스위트입니다. 이 저장소에서 설치한 사이트의 다음 Docker 스택에 대해 실행됩니다: `docker-compose.test.yml`(Selenium 허브, Chrome 노드, Maven 컨테이너). 로컬 체크아웃에서 실행하지 않습니다. 풀 리퀘스트 댓글에서 실행합니다. `.github/workflows/command-dispatcher.yml`(이)가 댓글을 워크플로 실행으로 바꿉니다. | 명령 | 스위트 | 워크플로 | |---|---|---| | `/e2e` | `chrome.editor.bs5.parallel.xml`과 익명 BS5 스위트. | `e2e-command.yaml` | | `/e2e-bs3` | `chrome.editor.bs3.parallel.xml` | `e2e-bs3-command.yml` | | `/e2eV2` | DXPR CMS 스택의 BS5 편집기 및 익명 스위트. | `e2eV2-command.yaml` | | `/qa-demo-2x-dxpr_theme6x-tests` | DXPR Theme 6.x QA 데모. | `qa-demo-2x-dxpr_theme6x-tests-command.yaml` | 옵션(`CONTRIBUTING.md`에 문서화): - `groups=row-element-test,icon-element-test`(은)는 스위트 XML의 이름 있는 `<test name="...">` 그룹을 실행합니다. - `tests=RowColumnLayoutVisualTest`(은)는 이름 있는 테스트 클래스를 실행합니다. - `maven_ref=branch-name`(은)는 `dxpr_maven` 브랜치를 씁니다. 빌더 변경과 테스트 업데이트를 함께 검토하는 방법입니다. 워크플로는 `target/reports/**`와 스크린샷을 빌드 아티팩트로 업로드하고 결과를 풀 리퀘스트 댓글로 게시합니다. 실패나 재시도에서만 통과한 테스트를 나열합니다. 각 스위트 작업의 제한 시간은 90분입니다. ## 린터와 정적 분석 각 린터는 Docker Compose 서비스이므로 Docker 외에 로컬 툴체인이 필요 없습니다. | 서비스 | 명령 | 검사 내용 | |---|---|---| | `drupal-lint` | `docker compose run --rm drupal-lint` | PHPCompatibility(PHP 8.3 이상), `Drupal`, `DrupalPractice` 표준의 phpcs. | | `drupal-check-D11` | `docker compose run --rm drupal-check-D11` | 다음이 있는 PHPStan 레벨 5: `mglaman/phpstan-drupal`. 실행 환경: `drupal/recommended-project` | | `eslint` | `docker compose run --rm eslint` | 다음의 ESLint와 맞춤법 검사: `js/`와 `dxpr_builder/build/`의 ESLint, `dxpr_builder/extracted_t_functions.js` | | `stylelint` | `docker compose run --rm stylelint` | 다음의 Stylelint: `dxpr_builder/sass/`와 `sass/` | | `rust-lint` | `docker compose run --rm rust-lint` | 다음의 Rust 소스 Clippy: `rust/` | | `no-jquery`, `no-underscore`, `html-in-js` | `docker compose run --rm <service>` | 다음의 지원 중단 감지기: `.github/workflows/deprecations.yml` | phpcs, ESLint, Stylelint에는 자동 수정 변형이 있습니다 (`drupal-lint-auto-fix`, `eslint-auto-fix`, `stylelint-auto-fix`). 같은 검사는 Docker 없이도 다음으로 쓸 수 있습니다: `npm run lint:scss`, `npm run lint:no-jquery`, `npm run lint:no-underscore`, `npm run lint:html-in-js`. `npm install`(은)는 Husky 사전 커밋 후크도 설치합니다 (`.husky/pre-commit`). 스테이징된 JavaScript, PHP, SCSS 파일과 Rust 소스에 맞는 자동 수정 및 린트 서비스를 실행하고, `docs/` 아래 파일이 스테이징되면 `docs/video-tools/bin/lint-videos.mjs`(을)를 실행합니다. `.github/workflows/review.yaml`(은)는 모든 풀 리퀘스트에서 바뀐 경로에 맞는 린터를 실행합니다. `.github/workflows/main.yaml`(은)는 `3.x`로의 모든 푸시에 `drupal-lint`, `eslint`, `drupal-check-D11`, `rust-lint`(을)를 실행합니다. 둘 다 검사가 실패하면 빌드를 실패시키고 위반 파일과 함께 요약을 기록합니다. ## 다음 단계 - [기여하기](/ko/hc/documentation/learn-dxpr-builder/development/contributing). 풀 리퀘스트 절차와 테스트 업데이트용 `maven_ref` 워크플로에 대한 내용. - [Drush 명령](/ko/hc/documentation/learn-dxpr-builder/development/drush-commands). Bash 스위트가 다루는 명령에 대한 내용.