October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

Cross-Browser Testing with Cypress: A Modern Guide

A practical guide to Cypress browser support, selecting a useful test matrix, running browsers locally and in CI, and handling WebKit and cross-origin limitations.

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.

Run Cypress against each browser your application promises to support, using an installed browser and cypress run --browser <browser>. Chrome-family browsers and Firefox are Cypress’s established choices; WebKit is available experimentally, with limitations that make it different from treating the run as a full Safari guarantee. Choose a matrix that fits your users, test runtime and CI capacity.

Which browsers can Cypress test?

Cypress’s cross-browser guide says it supports Chrome-family browsers, Firefox, and WebKit (Safari’s browser engine) (Cypress cross-browser testing guide). Its browser-launch reference lists Chrome for Testing, Chrome and preview channels, Chromium, Edge and preview channels, Firefox variants, deprecated Electron, and experimental WebKit (browser-launch reference).

Support is not identical across those choices. Cypress officially supports the latest three major versions of Chrome, Firefox, and Edge. In the current browser reference, Firefox versions below 140 cannot be launched; Cypress 15.0.0 through 15.18.1 instead had a floor of Firefox 135. Check the current reference when setting up or updating a CI image because browser support and minimum versions change.

WebKit is an experiment, not a Safari-equivalent guarantee

Cypress describes its WebKit implementation as an experiment based on Playwright WebKit and warns that issues may occur. Documented limitations include no cy.origin() support, incompatibility with Test Replay, and a disabled forceNetworkError option in cy.intercept(). Use it as additional engine coverage if it fits your tests, not as a drop-in substitute for every real Safari environment.

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

Choose a browser matrix that matches your support promise

Start with the browsers and versions your product explicitly supports, then consider where your users are and which browser-specific behavior could affect them. Cypress does not prescribe one universal matrix: its guidance is to balance confidence against test duration and infrastructure cost (cross-browser testing strategy).

Matrix approach When it fits Trade-off
One primary browser Fast feedback during local development or a narrowly scoped smoke run. Does not demonstrate behavior in other supported browser families.
Chrome-family plus Firefox A practical baseline when the application supports both families. Adds execution time and browser setup to CI.
Add Edge Edge is in the product’s support promise or important to its audience. Another browser run to maintain; Cypress’s official support covers the latest three major Edge versions.
Add WebKit experimentally You want early signal on Safari’s browser engine and can tolerate known Cypress limitations. Experimental support and unsupported features mean failures need interpretation rather than automatic treatment as a Safari defect.

For CI reproducibility, Cypress recommends Chrome for Testing where possible: its binaries are versioned and do not auto-update. Pinning the browser in the CI environment helps avoid silent changes between runs.

Install and run Cypress in another browser

  1. Install the browser in the developer machine or CI environment. Cypress detects installed browsers; a browser that is not present cannot be selected for the run.
  2. Run your suite with the browser name: cypress run --browser chrome, cypress run --browser firefox, or cypress run --browser edge. Use the browser name Cypress detects in that environment.
  3. Run a separate command for each matrix entry. For example, execute the same suite once with --browser chrome and again with --browser firefox. The selected browser applies to that run.
  4. For interactive runs, select the browser in the Cypress app. Use the browser selector in the app after Cypress detects installed browsers.
  5. In CI, keep the browser and Cypress versions deliberate. Prefer a versioned Chrome for Testing binary when feasible, and update the matrix intentionally rather than relying on an automatically changing browser installation.

Account for cross-origin and browser-specific behavior

Browser families do not expose every security or launch capability in the same way. Cypress documents that disabling web security is supported only on Chrome-based browsers. If a test relies on that setting, it will not transfer unchanged to Firefox or WebKit (Cypress cross-origin testing guide).

  • Keep tests aligned with the application’s real origin and security behavior rather than using a Chrome-only setting as a universal workaround.
  • When a test uses cy.origin(), do not expect it to run in WebKit under the documented current limitation.
  • Separate a browser-specific limitation from an application regression before making WebKit a required CI gate.

Plan CI runtime and reliability

Each additional browser run improves coverage of browser-specific differences but consumes execution time and CI capacity. A useful setup puts fast feedback where it is most valuable: run a smaller smoke subset across the matrix when appropriate, and use broader suites on a cadence your team can support. This is a trade-off, not a Cypress-prescribed schedule.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Reproducibility: use versioned browser binaries where available and record the browser/Cypress versions used by CI.
  • Maintenance: remove matrix entries that no longer match the supported-browser promise, and review changes to Cypress’s version floors and experimental features.
  • Failure diagnosis: compare the failing browser run with the same test in the primary browser, then inspect whether the test depends on a browser-specific capability.
  • Infrastructure: estimate total suite time and runner capacity before adding a browser as a blocking gate.

Troubleshoot common browser-run failures

“Browser not found” or no browser is available

The target browser may not be installed in the local or CI environment, or its detected name may differ from the name in the command. Install a supported browser and check the browsers Cypress detects, then pass the detected name to --browser.

Firefox will not launch

Check the Cypress browser reference for the minimum version in your Cypress release. The current reference says versions below Firefox 140 cannot be launched; Cypress 15.0.0–15.18.1 had a floor of 135. Updating or selecting a compatible Firefox version may be required.

A test passes in Chrome but fails elsewhere

Look for assumptions about browser-specific security settings, origin behavior, timing, or supported APIs. In particular, disabling web security is limited to Chrome-based browsers, and WebKit does not support cy.origin() under the documented limitations.

WebKit failures appear unrelated to the application

WebKit support is experimental, and Cypress lists other limitations such as Test Replay incompatibility and disabled forceNetworkError handling in cy.intercept(). Check those constraints before treating a failure as a reliable Safari result or a product regression.

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

CI results change unexpectedly over time

A browser binary that auto-updates can change between runs. Where feasible, use Chrome for Testing, which Cypress recommends for reproducibility because its binaries are versioned and do not auto-update.

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 screenshots of pages—not Cypress interaction tests—ScreenshotNeo provides a one-request screenshot API and an MCP server. It accepts cookie or consent banners like a visitor and removes 60+ known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status in headers. AI agents can use its MCP tools to take screenshots, get page information, and capture PDFs.

cURL example (see the ScreenshotNeo 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 includes 1,000 screenshots per month on its free plan with no card; paid plans start at $5 for 3,000. Sign up for free.

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

Frequently Asked Questions

Can Cypress run tests in Safari itself?

The documented experimental option is WebKit, Safari’s browser engine; Cypress cautions that it is not equivalent to a full Safari run in every context.

Can I select a different browser in Cypress without changing my tests?

Use the browser selector in the Cypress app for an interactive run, or choose the installed browser for a command-line run with --browser.

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

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

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Shenzhen desk3 min
    HONOR Expands Beyond Smartphones With Humanoid Robot RevealHONOR said it unveiled its first humanoid robot at MWC 2026 and named shopping assistance, workplace inspections, and supportive companionship as intended uses. Later Robotics D1 claims and a reported…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.