Set the browser viewport explicitly with cy.viewport(), visit the page, wait for the intended state, assert the responsive layout, and capture it with cy.screenshot(). Use { capture: 'viewport' } for one viewport image; Cypress otherwise defaults to a stitched full-page screenshot. Cypress captures images but does not compare them.
Capture the same page at responsive widths
Use a small set of widths chosen around your application’s actual CSS breakpoints. The dimensions below are illustrative, not Cypress-prescribed breakpoints. Replace the route and selector with ones from your application.
describe('responsive page screenshots', () => {
const widths = [390, 768, 1280]
widths.forEach((width) => {
it(`renders at ${width}px wide`, () => {
cy.viewport(width, 844)
cy.visit('/')
// Assert the layout you expect at this breakpoint.
cy.get('[data-testid="site-nav"]').should('be.visible')
cy.screenshot(`home-${width}`, { capture: 'viewport' })
})
})
})
For useful responsive coverage, include widths immediately on either side of important breakpoints when the layout changes there. Set the viewport inside each test or its setup so each capture has an explicit size. Cypress’s viewport API uses CSS-pixel dimensions; the preview pane may scale the application to fit your display.
Choose the viewport dimensions and configuration
cy.viewport(width, height) sets the application viewport in CSS pixels. It also accepts a documented device-size preset and optional portrait or landscape orientation. Before a test changes it, Cypress documents a default viewport of 1000 × 660, and it restores its default size between tests. See the Cypress viewport API.
#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.
To establish a suite-wide starting size, set viewportWidth and viewportHeight in Cypress configuration. Use cy.viewport() for per-test changes; current Cypress documentation says Cypress.config() cannot change those two values for the running test. Configuration options are documented in Cypress configuration.
A viewport preset is a convenient dimension choice, not a complete simulation of a named phone. Cypress does not simulate devicePixelRatio, so a resized viewport alone cannot establish touch behavior, physical-device rendering, or device-specific browser chrome.
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.
Choose what the screenshot contains
- One responsive viewport: Use
cy.screenshot('name', { capture: 'viewport' }). This is generally the clearest choice for comparing a particular responsive state. - The whole page: Cypress defaults to
capture: 'fullPage', which scrolls and stitches the page from top to bottom. Fixed and sticky elements can appear more than once in the resulting image. - The Cypress runner:
capture: 'runner'includes the Cypress Command Log. Failure screenshots are coerced to runner capture behavior. - A cropped area: Use
clip: { x, y, width, height }to specify the crop. - Hidden content: Use the
blackoutoption with selectors for elements you want hidden in an application capture.
Cypress disables timers and CSS animations by default during screenshot capture. The screenshot API also provides callbacks before and after capture, which can be used for controlled DOM changes and saved-image metadata. Check the screenshot API documentation for the current option details.
Wait for a stable page and assert the layout
Visit the route, then wait for a meaningful application condition before capturing. Prefer an assertion, an application signal, or a selector becoming available over an arbitrary delay. Screenshot capture is asynchronous, so the page can change between the command and the moment the image is taken.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsRank #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.
Make the test state what should be true at each width: for example, assert that a narrow layout shows a menu button, or that a grid has the expected number of columns. A screenshot records the result; an assertion makes the expected responsive behavior explicit. Cypress’s default disabling of timers and CSS animations helps, but it does not make changing backend data or application state deterministic.
For consistent visual results across runs, keep rendering environments consistent, wait for the page to settle, and control time-dependent content and application data. Cypress covers these practices in its visual testing guide.
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
Find and preserve screenshot artifacts
The default screenshot directory is cypress/screenshots; set screenshotsFolder in Cypress configuration to change it. In cypress run, Cypress automatically captures screenshots when tests fail by default. It also clears asset folders before a run unless trashAssetsBeforeRuns is disabled, so do not assume earlier screenshot artifacts will remain after another run.
Failure screenshots are taken in cypress run, not automatically in cypress open. They use runner capture behavior. See the configuration reference and screenshot API for related settings.
PC 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 & 11Outdated 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 matchBest 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.
Know what Cypress screenshots do—and do not—test
cy.screenshot() captures an image; it does not compare that image with a baseline. Cypress’s official visual testing guide states: “Cypress does not perform image comparison itself.” If you need visual diffs, baseline review, or rendering across browsers and responsive widths, add a visual testing integration. Cypress discusses options including Percy, LambdaTest SmartUI, Sauce Labs Visual, Chromatic, and Happo in its visual testing guide; compare them by browser and viewport support, where rendering and diffs run, baseline approval workflow, CI fit, and whether hosted review is needed.
Or skip the browser setup
If you need a screenshot without writing or maintaining a Cypress test, ScreenshotNeo accepts a URL in one GET request and returns a PNG, JPEG, WebP, or PDF. For example, this cURL request captures a page as WebP; see the ScreenshotNeo API documentation for parameters, authentication, and response details:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
ScreenshotNeo removes cookie and consent banners, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers indicate the page verdict and billing status. Its MCP server lets AI agents such as Claude and Cursor, or any MCP client, call screenshot tools. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.
Sign up for ScreenshotNeo’s free plan.
Common problems and fixes
- The screenshot has the wrong dimensions: Set
cy.viewport(width, height)in the test before visiting or capturing, and use CSS-pixel dimensions. Do not rely on a resized runner preview as the application viewport. - The image includes more than the visible screen: Cypress defaults to full-page capture. Specify
{ capture: 'viewport' }for just the current viewport. - Sticky headers or buttons repeat in the image: This can happen when full-page capture scrolls and stitches the page. Use viewport capture if you only need the visible state.
- The image sometimes shows different content: Capture is asynchronous. Wait for the relevant UI state and control dynamic data or time-dependent content; disabling timers and CSS animations does not stabilize a changing backend.
- Previous screenshots disappear after a run: Cypress clears asset folders before runs by default. Preserve assets with the documented
trashAssetsBeforeRunsconfiguration when appropriate, or collect artifacts as part of your run workflow. - You expected a visual regression result: Cypress screenshots alone do not compare images. Add a visual testing integration if you need baseline diffs and review.
- A viewport preset does not match a physical phone: Viewport resizing does not simulate
devicePixelRatioor all device behavior. Validate touch and device-specific rendering on an appropriate real-device or emulation workflow.
Frequently Asked Questions
What is Cypress’s default viewport size?
Cypress documents a default of 1000 × 660 CSS pixels before a test changes the viewport.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Does cy.screenshot() compare screenshots automatically?
No. It captures an image; image comparison requires a visual testing integration.
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.

