Running Tests

• Running Tests from the Web
  • Web test runner
• Running Tests from the Local System
• Install WPT
  • System Setup
    • Linux Setup
    • macOS Setup
    • Windows Setup
      • Windows Subsystem for Linux
    • hosts File Setup
  • Via the browser
  • Via the command line
    • Browser-specific instructions
      • Chrome and Chromium
      • Chrome for Android
      • Android WebView
        • Prerequisites
        • Running Tests
      • Safari
        • Debugging
      • WebKitGTK MiniBrowser
      • Nightly universal bundle
      • Headless mode
      • Using a custom WebKitGTK build
      • Running tests locally
      • WPE WebKit MiniBrowser
      • Nightly universal bundle
      • Headless mode
      • Using a custom WPE WebKit build
      • Running tests locally
    • Running in parallel
    • Output formats
    • Expectation data
  • Testing polyfills
• Running Tests on CI
• Writing Your Own Runner
• WPT Test Certificates
  • Trusting Root CA
  • Regenerating certificates
    • Implementation Details
    • Windows-specific Instructions

The simplest way to run the tests is via the public website. More detail on that approach is available in Running tests from the Web.

Contributors who are interested in modifying and creating tests should refer to Running Tests from the Local System.

Contributors with write access to the repository can also trigger full runs in our CI setups, see Running Tests on CI.

Advanced use cases may call for a customized method of executing the tests. Guidelines for writing a custom “runner” are available at Writing Your Own Runner.