Browser settings

Control the viewport dimensions that Test Companion uses when it captures screenshots and interacts with web pages.

Browser settings panel controls the viewport dimensions that Test Companion uses when it captures screenshots and interacts with web pages during browser-based tasks. Choosing the correct viewport size ensures that the AI sees your application the way your end users would see it on a specific device category.

How to open settings

1. Click the gear icon (⚙) in the top-right corner of the Test Companion panel.

   

2. Select the Browser Settings tab.

   

3. Make the necessary changes and click Save to apply them.
4. Click Cancel to discard any unsaved changes.

Viewport size

The viewport size defines the width and height of the virtual browser window that Test Companion uses when interacting with websites. This affects how web pages render, which elements are visible, and which responsive design breakpoints are triggered.

Available viewport options

Test Companion supports the following viewport options:

Large Desktop (1280×800)

The default setting. This matches a standard laptop display and is the most common viewport for desktop web testing.

Use this when:

• Your application is primarily used on desktop or laptop computers.
• You want to see the “full” version of a responsive website.
• You are generating tests for the standard desktop experience.
• You are not sure which viewport to choose (this is a safe default).

Small Desktop (900×600)

A narrower desktop viewport. Many responsive websites start to adjust their layout at this width, collapsing navigation menus or rearranging content into fewer columns.

Use this when:

• You want to test how your application responds to a smaller browser window.
• Your users frequently resize their browser windows or use split-screen setups.
• You need to verify that elements remain accessible at a reduced width.

Tablet (768×1024)

A portrait-orientation tablet viewport that matches common tablets like the iPad. At this size, most responsive websites switch to their tablet layout — typically a mix of mobile and desktop design elements.

Use this when:

• Your application has a tablet-specific layout you need to test.
• You are testing responsive behaviour at the tablet breakpoint.
• Your users access the application on iPads or similarly sized devices.

Mobile (360×640)

A portrait-orientation mobile viewport that matches a typical smartphone screen. At this size, responsive websites display their mobile layout — single-column content, hamburger menus, and touch-optimized controls.

Use this when:

• You are testing the mobile experience of your web application.
• You need to generate tests that verify mobile-specific UI elements (hamburger menus, swipe gestures, bottom navigation bars).
• Your product team needs mobile-specific test coverage.

How viewport size affects the AI’s behaviour

The viewport choice matters because Test Companion uses browser screenshots to “see” your application. When the AI takes a screenshot at a mobile viewport, it sees the mobile layout — and it tailors its actions and test generation accordingly.

For example:

• At Large Desktop, the AI may interact with a full navigation bar and side panel.
• At Mobile, the AI recognizes that it needs to tap a hamburger menu icon first to access navigation links, and it generates test steps accordingly.

This means you should match the viewport to the device your tests are meant to cover. If you are writing tests for the mobile experience, switch to Mobile viewport before starting the task. The AI’s understanding of your application changes based on what it “sees.”

Use case

Testing across multiple viewports

If you need to test the same feature across multiple device sizes (a common requirement for responsive design testing), you can:

1. Set the viewport to Large Desktop, generate or run your desktop tests.
2. Change the viewport to Tablet, then repeat the task for the tablet layout.
3. Change to Mobile and run the task again.

Each run will produce tests or interactions tailored to that specific viewport’s layout.