To run Selenium tests in GitHub Actions, add a workflow YAML file under .github/workflows, choose the events and runner, install the project’s pinned dependencies, run its existing test command, and upload reports or failure screenshots as artifacts. The exact setup depends on your language, test framework, browser, and runner image; the workflow below is an adaptable starting point, not a universal copy-and-paste configuration.
How a Selenium workflow fits together
GitHub Actions workflows are YAML files in .github/workflows. A workflow responds to repository events, a manual dispatch, or a schedule; it contains one or more jobs, and each job has steps that run scripts or actions. GitHub’s workflow documentation describes this model.
For browser tests, the essential sequence is: choose when to run, select an operating system and browser environment, check out the repository, configure the language runtime, install the dependencies your project pins, run its Selenium test command, then retain useful results and diagnostics.
Choose triggers and a runner
Run tests at the right times
Pull-request runs provide feedback on proposed changes; push runs can check integration on a branch such as main. A manual run or scheduled check can serve separate operational needs. GitHub supports event, manual, and scheduled triggers. A schedule is not a replacement for change-triggered checks, and scheduled workflows have lifecycle behavior: for example, GitHub documents that a deactivated scheduled workflow can be reactivated when a user with write permission changes its cron schedule. See workflow events and the schedule event.
Recommended Free Tools
#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.
Match the OS and browser to your test target
GitHub documents Linux, Windows, and macOS virtual-machine runners, and each job runs in its own virtual machine or container. Selenium WebDriver controls a browser through the WebDriver interface; Selenium’s documentation describes it as “an interface to write instruction sets that can be run interchangeably in many browsers.” Browser support does not mean every browser is already installed on every hosted runner image. Check the current image contents and select the OS/browser combination your application needs. Sources: GitHub-hosted runners and Selenium WebDriver.
Adapt this workflow to your repository
This illustrative outline demonstrates the workflow shape. Add the setup action, runtime version, dependency-install command, test invocation, report paths, and failure conditions used by your project. Confirm action versions and runner image details in current documentation before adopting them.
name: Selenium tests
on:
pull_request:
push:
branches: [main]
jobs:
selenium:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Set up the language runtime and version used by this repository.
# Install the pinned project dependencies.
# Run the repository's Selenium test command.
# Upload reports and failure screenshots even if tests fail.Fill in project-specific setup and test commands
There is no single install or test command for all Selenium projects. Use the repository’s lockfile and documented test runner so CI installs the same dependency versions the project expects. Keep the test command explicit, and make sure the browser test process exits unsuccessfully when a test fails; otherwise the workflow may appear green despite a failed test.
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.
Python and Selenium Manager
For modern Selenium Python bindings, Selenium Manager is the documented browser and driver management path for standard WebDriver creation. A basic launch can use webdriver.Chrome(), but it does not eliminate every environment concern: network restrictions, custom browser versions, unsupported platforms, or strict reproducibility needs may call for explicit browser and driver provisioning. See the Selenium Manager documentation.
For example, once Python, the pinned Selenium dependency, and a compatible browser environment are available, a minimal test script can create and close a driver as follows:
from selenium import webdriver
driver = webdriver.Chrome()
try:
driver.get("https://example.com")
assert "Example Domain" in driver.title
finally:
driver.quit()Remove the leading space before driver = if copying this block into a Python file; it should align with the statement below the import. Replace the example URL and assertion with the application and checks your tests actually require.
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.
Runner host or job container?
With no job-level container configured, steps run on the selected runner host unless an action itself runs in a container. GitHub also allows a job container through jobs.<job_id>.container. A container can standardize dependencies, but its image must include or obtain a compatible browser and required system libraries. This is a trade-off rather than an automatic improvement: host execution uses the runner’s environment, while a container makes you responsible for its browser and library setup. See running jobs in a container.
Keep test evidence when a run fails
Reports, logs, and screenshots help explain browser-test failures after the runner has finished. GitHub defines an artifact as “a file or collection of files produced during a workflow run”; its artifact guidance names test results, failures, and screenshots as common examples, and notes that artifacts remain available after a job subject to retention settings. See storing workflow data as artifacts.
- Configure tests to save reports and capture a screenshot when an assertion or browser step fails.
- Upload the relevant files with failure-tolerant workflow conditions, using the current Actions syntax and an artifact action version verified for your repository.
- Check the artifact retention setting that applies to the repository so the evidence remains available for the period your team needs.
Do not rely on a dependency cache to preserve diagnostics. Cache reusable dependencies or intermediate files; artifacts are for outputs you need to inspect after a run.
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
Troubleshoot common failures
The browser or driver cannot be found
Check which browser binaries are actually present on the selected runner image and whether the Selenium binding can obtain a compatible driver. For Python, Selenium Manager handles the common management path, but restricted network access or a custom browser setup can prevent automatic provisioning. Choose an explicit provisioning approach if the environment requires it.
Tests pass locally but fail in CI
Compare the OS, browser version, runtime, and pinned dependencies used locally with those in the workflow. Verify that the application is reachable from the runner and that tests do not depend on local files, interactive login, or timing assumptions absent from CI. Capture browser logs, test reports, and failure screenshots so the next run provides evidence rather than only a failed status.
The workflow is green but tests failed
Ensure the invoked test command returns a nonzero exit status on failure and that the workflow does not mask that status. Keep diagnostic upload steps failure-tolerant without making the test step itself appear successful.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
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.
The scheduled run does not happen
Confirm the workflow’s schedule and repository state, and review GitHub’s documented scheduled-workflow lifecycle rules. Keep pull-request or push triggers enabled for the change feedback your team needs.
Performance, reliability, and cost considerations
There is no universal runtime or reliability figure for Selenium workflows: outcomes depend on the suite, runner and browser environment, dependency setup, and application under test. For repeatability, pin project dependencies and make browser provisioning explicit when the default environment is insufficient. For useful failure diagnosis, preserve artifacts. For feedback timing and CI usage, choose triggers deliberately rather than running every suite on every possible event without need.
Or skip the browser setup
If your goal is a screenshot of a page rather than interactive Selenium assertions, ScreenshotNeo is a website screenshot API and MCP server. One GET request can return a PNG, JPEG, WebP, or PDF; its options also include full-page capture, element selection, and browser settings. It is not a replacement for a Selenium test suite that must interact with and assert on your application.
For example, this cURL request saves a WebP screenshot:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webpSee the ScreenshotNeo API documentation for setup and options. ScreenshotNeo removes cookie banners, popups, and chat widgets before the shot; bot checks, blank pages, and failed loads are never billed; its MCP server lets AI agents take screenshots; and 1,000 screenshots a month are free with no card, with paid plans starting at $5 for 3,000. Sign up for the free plan.
Frequently Asked Questions
Can I use GitHub Actions for Selenium tests in languages other than Python?
Yes. Configure the runtime, dependencies, and test command for the language and test framework used by your repository; the workflow structure is language-neutral.
Does using ScreenshotNeo run my Selenium assertions?
No. It captures page screenshots or PDFs; use Selenium when your tests need to control a browser and verify application behavior.
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.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitches
