메인 컨텐츠로 건너뛰기

시작하기

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

정보

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

공식 YouTube 채널 🎥

WebdriverIO에 관한 더 많은 비디오는 공식 YouTube 채널에서 찾을 수 있습니다. 꼭 구독해주세요!

WebdriverIO 설정 시작하기​

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

기존 프로젝트의 루트 디렉토리에 있다면 다음을 실행하세요:

npm init wdio@latest .

또는 새 프로젝트를 만들고 싶다면:

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

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

마법사는 설정을 안내하는 일련의 질문을 제시합니다. --yes 매개변수를 전달하여 Page Object 패턴을 사용하는 Chrome과 함께 Mocha를 사용하는 기본 설정을 선택할 수 있습니다.

npm init wdio@latest . -- --yes

CLI 수동 설치​

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

npm i --save-dev @wdio/cli
npx wdio --version # 예: `8.13.10` 출력

# 구성 마법사 실행
npx wdio config

테스트 실행​

run 명령어를 사용하고 방금 생성한 WebdriverIO 구성을 지정하여 테스트 스위트를 시작할 수 있습니다:

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 Recorder로 테스트 녹화를 참조하세요.

시스템 요구 사항​

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

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

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

Welcome! How can I help?

WebdriverIO AI Copilot