WebRunner Companion

Azure DevOps Web Runner Companion provides a seamless way to document and manage test evidence when executing tests using the Azure Test Plans Web Runner. This companion tool allows you to capture screenshots of your browser tab or full desktop, record videos of your test session with optional audio, and automatically log user actions such as clicks and page navigation. All captured artifacts are directly attached to your test results, ensuring that every detail is documented and traceable within Azure Test Plans.

Evidence capture

Take tab or full-desktop screenshots and annotate them with shapes, arrows, and text. Record screen videos with optional audio. Automatically capture user actions (clicks, keyboard input, and page navigation) as an image action log with embedded screenshots.

Attach to test results

All captured data uploads directly to the correct test run, test result, test iteration, and test step in Azure DevOps. Screenshots upload as PNG, videos as WebM, and action logs as self-contained HTML reports, all linked for end-to-end traceability.

Sign in & connect

Authenticate to Azure DevOps with a single click. The companion detects your signed-in Azure DevOps tab, acquires a session token, and handles all API communication securely using bearer token authentication. Supports multiple Azure DevOps organizations with automatic tab matching.

Quick start

1. Install the Web Runner Companion extension.
2. Open the extension popup and connect to your Azure DevOps organization.
3. Run tests from Azure DevOps web runner; the companion handles screenshot capture, screen recording, and image action logging automatically.

Prerequisites

Use Microsoft Edge or Google Chrome, version 138 or later. Sign in to Azure DevOps (Services or Server) in your browser.

Web Runner Companion or Test & Feedback Extension

• Web Runner Companion: Lightweight, purpose-built for Azure DevOps web runner data capture only.
• Test & Feedback extension: Full exploratory testing suite with standalone mode, connected mode, bug/task creation UI, timeline, and session management. More on the Test & Feedback extension here: https://marketplace.visualstudio.com/items?itemName=ms.vss-exploratorytesting-web

Running Manual Tests in Azure Test Plans

To learn more about how to run manual tests in Azure Test Plans, read: https://docs.microsoft.com/en-us/azure/devops/test/run-manual-tests?view=azure-devops

Supported Browsers

Install instructions

Google Chrome
To install the extension on Google Chrome:

• Click on Install link.
• You will be taken to Google Chrome web store in a new tab.
• Follow the steps from Chrome web store to install the extension.

Microsoft Edge
To install the extension on the new Microsoft Edge:

• Click on Install link.
• You will be taken to Edge add-ons page for the WebRunner Companion add-on.
• Click on Get button to add the add-on to your Edge browser.

Note: You need to install the extension or add-on only once. Afterwards your browser will update it automatically.