playwright-dev은(는) 무엇을 하나요?
Playwright 개발 방법을 설명합니다 - API, MCP 도구, CLI 명령어 및 벤더 종속성 추가하기.
개요
이 문서는 Playwright 프로젝트에 기여하는 개발자를 위한 안내서입니다. 다음 주제를 다룹니다:
- 새로운 API 추가
- MCP 도구 통합
- CLI 명령어 확장
- 벤더 종속성 관리
시작하기
개발 환경을 설정하려면 다음 단계를 따르세요:
- 저장소를 클론합니다:
git clone https://github.com/microsoft/playwright.git
cd playwright
- 종속성을 설치합니다:
npm install
npm run build
- 테스트를 실행합니다:
npm run test
API 추가
새로운 API를 추가하려면 src/ 디렉토리에서 적절한 모듈을 찾으세요. 예를 들어, Page 클래스에 새 메서드를 추가하려면 src/page/Page.ts 파일을 수정합니다.
예제: page.screenshot()
// src/page/Page.ts
async screenshot(options?: ScreenshotOptions): Promise<Buffer> {
// 구현
}
MCP 도구
MCP(Model Context Protocol) 도구를 통합하려면 tools/ 디렉토리를 참조하세요. 각 도구는 자체 설정 파일과 핸들러를 가집니다.
CLI 명령어
CLI 명령어는 src/cli/ 디렉토리에서 관리됩니다. 새 명령어를 추가하려면 commander를 사용합니다:
// 예제
program
.command('my-command')
.description('내 명령어 설명')
.action(async () => {
// 구현
});
벤더 종속성
외부 벤더 종속성은 vendor/ 디렉토리에 배치합니다. 각 벤더 패키지에 대한 라이선스 파일을 포함해야 합니다.
기여
기여하기 전에 CONTRIBUTING.md를 읽어주세요. 모든 풀 리퀘스트는 자동 CI 체크를 통과해야 합니다.