AI导哈

自动化测试框架

Playwright Project 是一个用于自动化测试的框架，支持端到端测试，包含示例测试和配置，可在本地或Docker环境中运行，并支持持续集成。

  • by Mufrad6502
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Mufrad6502/demo-automation-project-with-MCP

使用说明

Playwright Project

This project is set up for automation testing using Playwright. It includes example tests and configurations to help you get started with end-to-end testing.

Project Structure

  • tests/: Contains all the test files.
    • e2e/: End-to-end tests.
    • fixtures/: Test data and utility functions.
  • playwright.config.ts: Configuration file for Playwright.
  • package.json: Lists dependencies and scripts.
  • tsconfig.json: TypeScript configuration file.

Setup Instructions

Local Setup

  1. Clone the repository:

    git clone <repository-url>
cd playwright-project

  2. Install dependencies:

    npm install

Docker Setup

You can also run tests in Docker containers, which ensures consistent test environments and multi-browser testing:

  1. Make sure you have Docker and Docker Compose installed:

    docker --version
docker-compose --version

  2. Build the Docker containers:

    docker-compose build

  3. Run tests in all browsers (Chrome, Firefox, and WebKit):

    docker-compose up

    Or run tests in specific browsers:

    docker-compose up chrome-tests    # Run only Chrome tests
docker-compose up firefox-tests   # Run only Firefox tests
docker-compose up webkit-tests    # Run only WebKit tests

  4. To stop the containers:

    docker-compose down

The Docker setup provides:

  • Isolated test environment
  • Parallel test execution across browsers
  • Consistent browser versions
  • No need to install browsers locally

  1. Set up environment variables:

    cp .env.example .env

    Edit the .env file with your actual credentials. You can get the test credentials from:

    • https://www.saucedemo.com/ (for public test users)
    • Your team lead or project documentation (for private credentials)

    IMPORTANT:

    • Never commit the .env file to the repository
    • Never share your credentials in public
    • If you accidentally commit credentials, change them immediately

  2. Run the tests:

    npx playwright test

Continuous Integration

This project uses GitHub Actions for continuous integration. The workflow:

  • Runs on every push to main branch
  • Runs on every pull request to main branch
  • Installs dependencies and Playwright
  • Sets up environment variables from GitHub Secrets
  • Runs all tests
  • Uploads test reports as artifacts

Setting up GitHub Secrets

Before the CI can run tests, you need to set up these secrets in your GitHub repository:

  1. Go to your repository settings
  2. Navigate to Secrets and Variables > Actions
  3. Add the following secrets:
    • STANDARD_USER
    • STANDARD_PASSWORD
    • LOCKED_USER
    • LOCKED_PASSWORD
    • PROBLEM_USER
    • PROBLEM_PASSWORD
    • PERFORMANCE_USER
    • PERFORMANCE_PASSWORD

Test Reports

After each test run, a test report is generated and uploaded as an artifact. You can:

  1. Go to the Actions tab in your repository
  2. Click on the workflow run
  3. Download the playwright-report artifact
  4. Extract and open playwright-report/index.html in your browser

Usage Guidelines

  • Add your test cases in the tests/e2e/ directory.
  • Use the tests/fixtures/test-data.ts file to define any mock data or utility functions needed for your tests.
  • Modify the playwright.config.ts file to adjust settings as necessary.

License

This project is licensed under the MIT License.

相关 MCP