You can run Playwright screenshot tests in GitHub Actions without a runner charge for a public repository using GitHub-hosted standard runners. For a private repository, “free” depends on the minutes and storage included with your account plan; usage beyond those allowances can be billed. Self-hosted runners have no GitHub Actions minute charge, but you supply and operate the machine.
This guide sets up a JavaScript Playwright workflow, saves its report as an artifact, and explains what to check before treating a private workflow as free.
What you need before adding the workflow
- A JavaScript project with Playwright included in its dependencies and a committed lockfile, so
npm cican install the versions recorded by the project. - At least one Playwright test that checks a screenshot or visual baseline. GitHub Actions runs the suite; it does not create visual assertions automatically.
- A GitHub repository and permission to add files under
.github/workflows/.
Playwright tests can run on any CI provider, and Playwright documents GitHub Actions as a supported setup: Playwright CI documentation.
Add a GitHub Actions workflow
Create .github/workflows/playwright.yml in the repository. This example follows Playwright’s JavaScript workflow pattern: it checks out the code, sets up Node, installs locked dependencies and browser dependencies, runs tests, then uploads the report even if tests fail (unless the job is cancelled).
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
name: Playwright screenshot tests
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: lts/*
- run: npm ci
- run: npx playwright install --with-deps
- run: npx playwright test
- uses: actions/upload-artifact@v4
if: ${{ !cancelled() }}
with:
name: playwright-report
path: playwright-report/
retention-days: 30The action versions and 30-day retention shown here reflect the Playwright documentation’s example configuration; they are not universal retention requirements. Check the current CI guide when setting up or maintaining the workflow, and adjust branch names and Node configuration for your project.
Make sure the report exists
The example uploads playwright-report/. Configure Playwright to produce that report, for example in playwright.config.js:
import { defineConfig } from '@playwright/test';
export default defineConfig({
reporter: 'html',
});If your project uses a different config file or report directory, update the workflow’s path to match. Add Playwright to the project dependencies and commit the resulting lockfile before relying on npm ci.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Write a screenshot assertion that CI can run
Put visual assertions in the regular Playwright test suite. For example, a test can visit a page and compare it with a stored screenshot baseline:
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →import { test, expect } from '@playwright/test';
test('homepage matches its visual baseline', async ({ page }) => {
await page.goto('https://example.com');
await expect(page).toHaveScreenshot('homepage.png');
});Replace the URL and test with your own application. On an initial run, Playwright may need a baseline generated and reviewed for your environment; commit approved baselines so CI can compare against them. A failed visual comparison should be investigated rather than automatically accepted as a new baseline.
Keep screenshot results consistent
Screenshot comparisons are sensitive to the rendering environment. Browser versions, operating-system dependencies, fonts, viewport settings, and page state can all affect pixels. Use a consistent browser and environment for creating baselines and running CI. Playwright documents containers as one way to isolate dependencies and make screenshot or visual-regression environments more consistent; its CI guidance also describes using a single worker when stability matters.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
- Install browsers and required OS packages in the runner with
npx playwright install --with-deps. - Keep browser and Playwright dependency versions controlled through the project’s lockfile and repeatable setup.
- Stabilize the page under test: wait for relevant content, avoid changing data, and account for animations or dynamic content in your test design.
- If concurrent tests create instability or resource pressure, consider Playwright’s documented single-worker CI configuration.
What “free” means in GitHub Actions
Cost depends on repository visibility, runner type, account allowance, actual workflow runtime, and artifact storage. GitHub says standard GitHub-hosted runner usage is free for public repositories. Private repositories use the free minutes and storage included with the account’s plan; amounts vary, and overage can be billed. Self-hosted runners do not incur GitHub Actions minute charges, although you are responsible for the machine and its operation. Check GitHub Actions billing and the account’s current billing details before estimating private-repository costs.
| Setup | GitHub Actions minute charge | What to verify |
|---|---|---|
| Public repository, GitHub-hosted standard runner | Free runner usage, according to GitHub’s billing documentation | Artifact and other applicable usage; confirm current account details. |
| Private repository, GitHub-hosted runner | Uses account-plan allowances; excess usage can be billed | Included minutes, storage, actual run time, and overage rates for the account. |
| Self-hosted runner | No GitHub Actions minute charge | You provide, maintain, and pay for the machine and its operating costs. |
Do not assume that a private repository is free simply because the workflow runs successfully. For private projects, calculate expected usage from the workflow’s run frequency and duration, then compare it with the account’s available allowance and artifact storage use.
Inspect a run and retrieve its report
- Push the workflow file and test code, or open a pull request targeting one of the configured branches.
- In the repository, open the Actions tab and select the Playwright screenshot tests run.
- Check the job log to see whether dependency installation, browser setup, or a test failed.
- When the job has an uploaded artifact, download
playwright-reportfrom the run summary and open the HTML report locally.
The example configures the artifact to be retained for 30 days. Change the retention value to suit the repository’s needs and applicable storage allowance.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Troubleshooting common failures
npm ci fails
Check that the lockfile is committed and synchronized with package.json. npm ci installs from the lockfile rather than resolving an unconstrained dependency set.
Playwright cannot find a browser or system library
Ensure the browser-install step runs before tests and includes --with-deps on the Linux runner. If the project uses a custom container or operating system, follow the corresponding Playwright CI setup rather than assuming the Ubuntu dependencies apply.
The artifact is missing
Verify that the reporter writes to playwright-report/ and that the upload step’s path matches the actual output directory. The upload step is skipped if the job is cancelled; an earlier setup failure may also prevent the directory from being created.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Screenshots differ in CI but pass locally
Compare browser and OS environments, viewport and device scale, fonts, page data, and timing. Generate or review baselines using the same controlled environment as CI; a container is one documented option for dependency consistency.
A private workflow unexpectedly costs money
Check repository visibility, runner type, account plan allowances, consumed minutes, and artifact/storage usage in the GitHub billing details. Private-repository allowances differ by account plan, and usage beyond included amounts can be billed.
Or skip the browser setup:
If you need a clean capture of a website rather than a Playwright visual-regression test against committed baselines, ScreenshotNeo returns a screenshot or PDF from one GET request. Its API can capture PNG, JPEG, or WebP; see the API documentation.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpScreenshotNeo accepts cookie and consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be disabled individually. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and the response reports the page verdict and billing status in headers. Its MCP server offers take_screenshot, get_page_info, and capture_pdf for AI agents and MCP clients. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallOutdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchSign up for ScreenshotNeo’s free plan to try 1,000 screenshots a month with no card.
Frequently Asked Questions
Can I use GitHub Actions for Playwright visual regression tests?
Yes. Playwright’s CI documentation supports GitHub Actions as well as other CI providers.
Does Playwright screenshot testing replace a full visual testing service?
Playwright can run screenshot assertions and compare baselines in your test suite; whether that is sufficient depends on your project’s review and baseline-management needs.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
