Run Playwright tests on GitHub Actions
Перейти к файлу
Max Schmitt b8e84efb03
chore: update dependencies (#82)
2023-09-19 00:27:49 +02:00
.github/workflows devops: upgrade GHA workflows (#81) 2023-09-19 00:23:44 +02:00
dist chore: update dependencies (#82) 2023-09-19 00:27:49 +02:00
sample fix: fix missing libraries for Firefox and WebKit (#25) 2020-07-29 10:38:23 -07:00
.eslintignore chore: bump dependencies (#68) 2022-06-10 00:55:35 +02:00
.eslintrc.json feat: initial setup 2020-04-08 08:47:46 -07:00
.gitignore chore: added lock file (#60) 2022-03-14 19:49:58 +01:00
CODE_OF_CONDUCT.md Initial CODE_OF_CONDUCT.md commit 2020-03-04 12:37:42 -08:00
CONTRIBUTING.md docs: update readme and development docs (#9) 2020-04-15 15:46:30 -07:00
DEVELOPMENT.md docs: update development docs (#62) 2022-03-14 12:08:07 -07:00
LICENSE Initial LICENSE commit 2020-03-04 12:37:45 -08:00
README.md docs: fix broken badge images 2022-11-04 11:28:44 -07:00
SECURITY.md Initial SECURITY.md commit 2020-03-04 12:37:43 -08:00
action.yml chore: use node20 (#80) 2023-09-19 00:26:38 +02:00
index.js chore: add libsoup-3.0-0 (#79) 2023-09-19 00:16:32 +02:00
package-lock.json chore: update dependencies (#82) 2023-09-19 00:27:49 +02:00
package.json chore: update dependencies (#82) 2023-09-19 00:27:49 +02:00

README.md

Playwright GitHub Action

tests

Set up GitHub Actions to run cross-browser tests on Chromium, WebKit and Firefox with Playwright.

You don't need this GitHub Action

We recommend using the Playwright CLI instead of this GitHub Action.

One of the reasons for deprecating the GitHub Actions is that it doesn't know which version of Playwright is installed, which then requires installing many more dependencies to ensure support.

We highly discourage the use of the GitHub Action. See next section for using the CLI.

Use the Playwright CLI

Starting with Playwright v1.8.0 it includes a CLI that installs all required browser dependencies.

To install dependencies with a CLI:

npx playwright install-deps # install dependencies for all browsers
npx playwright install-deps chromium # install dependencies for Chromium only

Playwright CLI with GitHub Actions CI

Following is an example usage of the Playwright CLI with a GitHub Actions workflow file. It shows a tests_e2e job which includes steps in which the Playwright CLI invokes the installation of required dependencies (headless browsers, etc) and then invokes the actual npm run script npm run test:e2e for the Playwright test runner:

jobs:
  tests_e2e:
    name: Run end-to-end tests
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
      - name: Install dependencies
        run: npm ci
      - name: Install playwright browsers
        run: npx playwright install --with-deps
      - name: Run tests
        run: npx playwright test

If something doesn't work, please let us know!

⚠️ GitHub Action Usage (deprecated)

Add uses: microsoft/playwright-github-action@v1 to the GitHub workflow definition before running your tests.

on:
  push:
    branches:
    - main

jobs:
  e2e-tests:
    runs-on: ubuntu-latest # or macos-latest, windows-latest

    steps:
      - uses: actions/checkout@v2

      - uses: actions/setup-node@v1

      - uses: microsoft/playwright-github-action@v1

      - name: Install dependencies and run tests
        run: npm install && npm test

Upload artifacts

This GitHub Action can be combined with the Upload Artifact action to upload test artifacts (like screenshots or logs).

steps:
- uses: microsoft/playwright-github-action@v1

- name: Install dependencies and run tests
  run: npm install && npm test

- uses: actions/upload-artifact@v2
  if: ${{ always() }}
  with:
    name: test-artifacts
    path: path/to/artifacts

Run in headful mode

This GitHub Action can also execute tests in headful mode. To do this, use xvfb-run on a Linux agent.

# Windows/macOS
npm test

# Linux
xvfb-run --auto-servernum -- npm test

Resources