메인 컨텐츠로 건너뛰기

시작하기

WebdriverIO 문서에 오신 것을 환영합니다. 이 문서는 빠르게 시작하는 데 도움이 될 것입니다. 문제가 발생하면 Discord 지원 서버에서 도움과 답변을 찾을 수 있으며, 𝕏에서도 연락할 수 있습니다.

정보

이 문서는 최신 버전(>=9.x)의 WebdriverIO에 대한 것입니다. 아직 이전 버전을 사용하고 계시다면, 이전 문서 웹사이트를 방문해 주세요!

공식 유튜브 채널 🎥

공식 유튜브 채널에서 WebdriverIO에 관한 더 많은 동영상을 찾을 수 있습니다. 구독하는 것을 잊지 마세요!

WebdriverIO 설정 시작하기​

WebdriverIO 스타터 툴킷을 사용하여 기존 또는 새 프로젝트에 전체 WebdriverIO 설정을 추가하려면 다음을 실행하세요:

기존 프로젝트의 루트 디렉터리에 있는 경우 다음을 실행하세요:

npm init wdio@latest .

또는 새 프로젝트를 생성하려면:

npm init wdio@latest ./path/to/new/project

이 명령은 WebdriverIO CLI 도구를 다운로드하고 테스트 스위트를 구성하는 데 도움이 되는 구성 마법사를 실행합니다.

마법사는 설정 과정을 안내하는 일련의 질문들을 제시할 것입니다. --yes 매개변수를 전달하여 페이지 객체 패턴을 사용하여 Chrome으로 Mocha를 사용하는 기본 설정을 선택할 수 있습니다.

npm init wdio@latest . -- --yes

CLI 수동 설치하기​

CLI 패키지를 프로젝트에 수동으로 추가할 수도 있습니다:

npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`

# run configuration wizard
npx wdio config

테스트 실행하기​

방금 생성한 WebdriverIO 구성을 가리키는 run 명령을 사용하여 테스트 스위트를 시작할 수 있습니다:

npx wdio run ./wdio.conf.js

특정 테스트 파일을 실행하려면 --spec 매개변수를 추가할 수 있습니다:

npx wdio run ./wdio.conf.js --spec example.e2e.js

또는 구성 파일에서 스위트를 정의하고 스위트에 정의된 테스트 파일만 실행할 수 있습니다:

npx wdio run ./wdio.conf.js --suite exampleSuiteName

스크립트에서 실행하기​

Node.JS 스크립트 내에서 독립 실행 모드로 자동화 엔진으로 WebdriverIO를 사용하려면, WebdriverIO를 직접 설치하여 패키지로 사용할 수도 있습니다. 예를 들어 웹사이트의 스크린샷을 생성하는 경우:

getting-started/run-in-script.js
loading...

참고: 모든 WebdriverIO 명령은 비동기식이며 async/await을 사용하여 적절히 처리해야 합니다.

테스트 기록하기​

WebdriverIO는 화면에서 테스트 작업을 기록하고 WebdriverIO 테스트 스크립트를 자동으로 생성하는 데 도움이 되는 도구를 제공합니다. 자세한 내용은 Chrome DevTools 레코더로 테스트 기록하기를 참조하세요.

시스템 요구 사항​

Node.js가 설치되어 있어야 합니다.

  • 최소 v18.20.0 이상을 설치하세요(가장 오래된 활성 LTS 버전)
  • LTS 릴리스이거나 앞으로 LTS 릴리스가 될 버전만 공식적으로 지원됩니다

Node가 현재 시스템에 설치되어 있지 않다면, NVM이나 Volta와 같은 도구를 사용하여 여러 활성 Node.js 버전을 관리하는 것이 좋습니다. NVM은 인기 있는 선택이며, Volta도 좋은 대안입니다.

Welcome! How can I help?

WebdriverIO AI Copilot