Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run Argos visual checks in a Docker container by using the official Microsoft Playwright image with the same version as your project’s Playwright package, installing dependencies from the lockfile, and passing ARGOS_TOKEN as a CI secret. Configure the Argos Playwright reporter and capture a named, deterministic page state with argosScreenshot. Docker standardizes the browser and operating-system environment; it does not by itself prevent version mismatches, dynamic-page flakiness, or secret leaks.

Set up a version-matched Playwright container

The official Playwright image includes browser binaries and their operating-system dependencies, but it does not install your project’s Playwright package. Install your locked project dependencies in the job, and keep the image tag aligned with the Playwright version declared by your project. A mismatch can leave Playwright unable to find the browser executable it expects. Microsoft recommends pinning the image to a specific version rather than relying on a moving tag: Playwright Docker documentation.

As of October 3, 2026, the documentation lists Playwright v1.63.0 tags including noble and jammy. These are point-in-time examples, not a recommendation to upgrade blindly; use the tag matching your installed package and re-check available tags when updating.

GitHub Actions example

This illustrative job runs tests inside the container, installs dependencies with npm ci, and makes the Argos token available only to the test step. Confirm the action version and container syntax against your CI provider and repository setup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • 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: visual-tests
on: [pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    container:
      # Keep this Playwright version aligned with @playwright/test in package-lock.json.
      image: mcr.microsoft.com/playwright:v1.63.0-noble
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npx playwright test
        env:
          ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}

Use the equivalent secret store in another CI system; do not commit the token in source code or a checked-in configuration file. If your project uses another package manager, install from its committed lockfile instead of copying npm ci unchanged.

Configure the Argos reporter and capture a page

Install and configure the Argos Playwright integration as described in the Argos Playwright guide. The reporter can be enabled for CI runs while keeping a local reporter for developer runs:

import { defineConfig } from "@playwright/test";

export default defineConfig({
  reporter: [
    process.env.CI ? ["dot"] : ["list"],
    ["@argos-ci/playwright/reporter", { uploadToArgos: !!process.env.CI }],
  ],
});

Navigate to the state you intend to compare, then call argosScreenshot(page, "name") with a stable name:

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 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.
import { argosScreenshot } from "@argos-ci/playwright";
import { test } from "@playwright/test";

test("homepage visual", async ({ page }) => {
  await page.goto("http://localhost:3000/");
  await argosScreenshot(page, "homepage");
});

The example assumes the application is available at http://localhost:3000/. Start the application before the test command or change the test URL to a deployed preview address. Argos’s helper waits for fonts, images, and network idle and hides carets and scrollbars; tests still need deterministic data, interactions, and an appropriate target state.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Make the CI environment reliable

Make the app reachable and the inputs repeatable

  • Start the application as part of the CI job before Playwright runs, or target a deployment preview. Argos’s Vercel Preview guide shows the preview-URL approach.
  • Install from the lockfile and run tests in the same pinned container used for the CI check. This reduces drift in browser, operating-system libraries, and fonts.
  • Wait for the meaningful page state and control changing data, animations, timestamps, and other dynamic content. Mask or hide genuinely variable regions where appropriate.
  • Keep functional assertions in Playwright tests; visual capture is a separate check of rendered appearance.

Account for Docker runtime settings

Playwright recommends --ipc=host for Chromium because a small default shared-memory allocation can contribute to browser crashes, and recommends Docker’s --init option to help handle PID 1 and avoid zombie processes. How to provide these settings depends on the CI runner. The Playwright image runs as root by default, which disables Chromium’s sandbox. Playwright says that can be acceptable for trusted end-to-end tests; for untrusted browsing or scraping, use a separate user and suitable seccomp configuration. The project cautions that its image is intended for testing and development, not visiting untrusted websites (Playwright Docker documentation).

Choose between Argos and native Playwright snapshots

Native Playwright screenshots and Argos solve related but different baseline-management problems. Argos describes its workflow and comparison with native screenshots in its Playwright guide.

Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • 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.
Decision Native Playwright screenshots Playwright capture with Argos
Baseline storage Screenshot files in Git Hosted Argos build associated with Git history
Review and updates Run npx playwright test --update-snapshots in a controlled environment and inspect changed files Review and approve visual differences through the pull-request workflow
Workflow fit Useful for a small suite where version-controlled files and direct local review are sufficient Useful when a team wants centralized review and less baseline-file maintenance

For native snapshots, generate and update baselines in the same Docker environment used in CI; operating systems, browser versions, fonts, and antialiasing can change rendered pixels. With either workflow, inspect visual changes before accepting them. For a cost decision about Argos, check its current plan details directly; pricing is not needed to configure this Docker workflow.

Troubleshoot common Docker visual-test failures

Playwright cannot find a browser executable

Check that the container image’s Playwright version matches the package version installed from the lockfile. Also verify that the job actually installs project dependencies: the image supplies browser binaries and system libraries, not the project’s Playwright package.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Chromium crashes or exits unexpectedly

Where your runner permits, use Docker’s --ipc=host setting to avoid Chromium issues caused by limited shared memory. Consider --init for process cleanup. CI providers expose container options differently, so consult the provider’s job configuration rather than assuming these flags are accepted in the YAML example above.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • 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

The page is blank, unreachable, or captured too early

Confirm the server starts successfully before the test, that the URL resolves from inside the container, and that the app is ready before navigation or capture. For preview deployments, pass the actual preview URL. Add a wait for a meaningful selector or state when navigation alone does not mean the page is ready.

Screenshots differ between local and CI runs

Use the same pinned image and browser/package versions locally and in CI where possible. Keep native baselines generated in that environment; differences in OS rendering, installed fonts, and antialiasing can persist when environments differ.

Captures are flaky despite the Argos helper

The helper’s waits do not make changing application content deterministic. Stabilize fixtures and time-dependent data, wait for the intended interaction or selector, and hide or mask variable content when it is not part of the visual check.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 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.

The reporter uploads nothing or the token is rejected

Verify the reporter is enabled for the CI run, ARGOS_TOKEN is configured as a CI secret and exposed to the test step, and the secret is available to that event type. In particular, CI platforms may restrict secrets in pull requests originating from forks; follow the provider’s security rules rather than exposing the token to untrusted code.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

For a website screenshot rather than a Playwright visual-regression test, ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return a screenshot or PDF; 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.webp

ScreenshotNeo accepts cookie or consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, with response headers reporting the page verdict and billing status. Its MCP server offers take_screenshot, get_page_info, and capture_pdf for AI agents. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots.

Sign up for 1,000 free screenshots a month, with no card required.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Frequently Asked Questions

Does the Playwright Docker image install the Playwright package for my project?

No. It provides browser binaries and operating-system dependencies; install your project dependencies from its lockfile in the CI job.

Can I use Argos visual tests without Docker?

Yes. Docker is an environment-standardization choice for Playwright tests, not a requirement of the Argos reporter.

Can ScreenshotNeo replace Argos for visual regression testing?

No. ScreenshotNeo returns website captures; the Argos workflow described here uploads Playwright captures for hosted visual comparison and pull-request review.

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.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.