Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Use npx cypress open to author and debug tests in Cypress’s interactive Test Runner. Use npx cypress run to execute tests to completion, usually headlessly, including in CI. Most projects need both: open mode for development and run mode for repeatable checks.
What the Cypress CLI and Test Runner do
The CLI is how you launch Cypress and control test runs from a terminal. The Test Runner is the interactive environment used in open mode: it displays specs and test execution, updates the Command Log, and lets you inspect and step through behavior while debugging. Cypress describes it this way: “The Cypress Test Runner is where you run and debug specs in open mode.” Cypress open-mode guide.
| Workflow | Command | Best for | Browser display |
|---|---|---|---|
| Interactive open mode | npx cypress open |
Writing, inspecting, and debugging specs on a developer machine | Interactive Cypress app and browser |
| CLI run mode | npx cypress run |
Repeatable execution, scripts, and CI | Headless by default; can be shown with --headed |
Install Cypress and launch it for the first time
Install Cypress as a development dependency using the package manager already used by the project. Run commands from the project root.
npm install cypress --save-devyarn add cypress --devpnpm add --save-dev cypressbun add --dev cypress
Then launch the interactive app with npx cypress open (or the equivalent package-manager command). On first launch, Cypress’s Launchpad guides you through choosing a testing type, creating configuration and folder structure, and selecting a browser. See the Cypress installation guide and open-mode guide.
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.
Package and application binary are separate
The npm package and Cypress application binary are distinct parts of installation. Normally, package installation downloads the binary through a postinstall step. If lifecycle scripts are blocked, binary download was skipped, or your CI cache setup installs it separately, run the package-manager form of cypress install. Cypress documents environment controls for customizing binary installation and cache behavior in its advanced installation guide.
Use open mode to author and debug specs
- From the project root, run
npx cypress open. - In Launchpad, select the testing type and follow the prompts to configure the project if it is not configured yet.
- Choose an available browser and select a spec in the Cypress app.
- Use the browser and Command Log to inspect the test as it runs; save changes to a spec to rerun it while authoring.
Open mode is the natural choice when you need to see what a test does and investigate a failure. To give teammates a consistent entry point, define scripts in package.json:
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.
{
"scripts": {
"cy:open": "cypress open",
"cy:run": "cypress run"
}
}Then run npm run cy:open or npm run cy:run. Avoid naming a script cypress: Cypress warns that Yarn may resolve a script with that name instead of the Cypress binary. See the open-mode documentation.
Run tests from the CLI
Run all configured specs to completion with:
npx cypress runRun mode is headless by default, making it suitable for automated execution. To see the browser while running, add --headed. For example:
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
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.
npx cypress run --headedChoose a testing type, spec, or browser
Use the CLI options to narrow or direct a run:
--e2eor--componentselects the testing type.--specselects one spec or a glob, such as--spec "cypress/e2e/login.cy.js".--browserselects a detected browser or accepts a browser path.
Example command:
npx cypress run --e2e --browser chrome --spec "cypress/e2e/login.cy.js"The target spec must also match the configured specPattern; choosing a file with --spec does not make an excluded file eligible. Browser availability depends on the local environment. Consult the current CLI reference and browser documentation for compatibility details.
Report results and organize Cloud runs
--reporterselects a Mocha reporter;--reporter-optionsconfigures it. A CI workflow may use a JUnit reporter to emit machine-readable results.--recordrecords a run with Cypress Cloud.--groupand--tagorganize recorded runs.--parallelenables parallelization of recorded specs across multiple machines; it is for Cypress Cloud-recorded runs, not a general local parallel switch.
Check the CLI reference for exact option syntax and the current Cloud requirements.
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
Configure a run without changing project defaults
Cypress reads project settings from its configuration file. Use --config-file to select a different file, --config to override configuration values for a command, and --env to pass test environment values. Command-line configuration overrides the file’s values. CYPRESS_-prefixed environment variables can override configuration in a particular environment; see the configuration reference and CLI reference.
npx cypress run --config-file cypress.ci.config.js --config viewportWidth=1280,viewportHeight=800 --env stage=ciUse the project’s actual configuration filename and values. Do not place credentials directly in a command or commit them in configuration: command-line secrets may appear in CI logs. Store secrets in your CI/CD provider’s secret-management system and expose them to the job as needed. Cypress covers CI configuration and secret handling in its CI guide.
Free tools Windows power users keep installed
One-click scans. No signup required.
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.
Make Cypress runs reliable in CI
- Install dependencies and ensure the Cypress binary is available; use
cypress installseparately if your setup skipped the normal binary download. - Start the application under test.
- Wait until the application responds at the expected URL.
- Run Cypress, typically with
cypress run.
Do not start a server in the background and immediately invoke Cypress. That creates a race: tests may start before the application is ready. Use a readiness-waiting tool or the documented start and wait-on options in the official GitHub Action. Cypress also documents environment-variable configuration for values such as base URL, reporter, and viewport. See the CI overview.
Containers have different display needs
Headless cypress run works in a container when the image has the required Linux prerequisites; Cypress’s official Docker images include them. Interactive cypress open requires a graphical display, which containers do not provide by default. For container guidance, see Cypress CI documentation and the advanced installation guide.
Troubleshoot common setup and run failures
- The Cypress app or binary is missing: The package may be installed without its separate application binary, especially if lifecycle scripts were disabled. Run the package-manager form of
cypress installand check the installation guide’s binary and cache settings. - No spec is found: Confirm the path or glob passed to
--specis correct and that the file matches the configuredspecPattern. - The selected browser does not launch: Check that the browser is installed and detected, or supply a supported browser path. Consult the current browser compatibility documentation before relying on a specific browser.
- Tests fail because the app is unavailable: Ensure the server starts successfully and add a readiness wait before Cypress starts; an immediate background launch is not a readiness check.
cypress opencannot display in a container: Open mode needs a graphical display. Use headlesscypress runin a suitable image or provide a display environment.- A Yarn command runs an unexpected script: Rename a project script called
cypressto a less ambiguous name such ascy:open. - A secret appears in logs: Remove it from the command line and use your CI platform’s protected secret mechanism.
Or skip the browser setup
If you need a website screenshot rather than an interactive Cypress test, ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return an image 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.webpScreenshotNeo removes cookie/consent banners, newsletter popups, and chat widgets before capture. Bot checks, blank pages, failed loads, timeouts, and cache hits are not billed. Its MCP server provides screenshot tools for AI agents. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 shots. Sign up for free.
Frequently Asked Questions
Can I use Cypress open mode in CI?
It is possible only when the environment can provide the graphical display that interactive open mode requires; the usual CI workflow is headless `cypress run`.
Does `–parallel` make a local Cypress run use multiple machines?
No. Cypress documents parallelization for recorded specs across multiple machines with Cypress Cloud.
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.
