Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 5 additions & 8 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -294,15 +294,12 @@ export default defineConfig({
label: 'Browser Extension',
collapsed: true,
items: [
{ label: 'Install and Update', link: '/advanced/browser-extension/install' },
{ label: 'Connect', link: '/advanced/browser-extension/connect' },
{ label: 'Run a Manual Run', link: '/advanced/browser-extension/run-tests' },
{ label: 'Attach a Screenshot', link: '/advanced/browser-extension/screenshots' },
{ label: 'Attach a Screen Recording', link: '/advanced/browser-extension/screen-recording' },
{ label: 'Console & Network Log', link: '/advanced/browser-extension/console-network-log' },
{ label: 'Overview', link: '/advanced/browser-extension' },
{ label: 'Install and Connect', link: '/advanced/browser-extension/install' },
{ label: 'Run Manual Tests', link: '/advanced/browser-extension/run-tests' },
{ label: 'Attach Screenshots, Recordings, and Logs', link: '/advanced/browser-extension/attachments' },
{ label: 'Create Tests', link: '/advanced/browser-extension/create-tests' },
{ label: 'Step Recorder', link: '/advanced/browser-extension/step-recorder' },
{ label: 'Settings and Shortcuts', link: '/advanced/browser-extension/settings' },
{ label: 'Settings', link: '/advanced/browser-extension/settings' },
],
},
{
Expand Down
5 changes: 5 additions & 0 deletions redirects.js
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,11 @@ const redirects = {
"/project/tests/other-features-for-test-case-design": "/project/tests/sharing-tests-and-suites",
"/project/test_design_features": "/project/tests/sharing-tests-and-suites",
"/project/copy_move_tests": "/project/tests/copying-tests-and-suites",
"/advanced/browser-extension/connect": "/advanced/browser-extension/install",
"/advanced/browser-extension/screenshots": "/advanced/browser-extension/attachments",
"/advanced/browser-extension/screen-recording": "/advanced/browser-extension/attachments",
"/advanced/browser-extension/console-network-log": "/advanced/browser-extension/attachments",
"/advanced/browser-extension/step-recorder": "/advanced/browser-extension/create-tests",
}

export default redirects
102 changes: 102 additions & 0 deletions src/content/docs/advanced/browser-extension/attachments.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
title: Attach Screenshots, Recordings, and Logs
description: Capture and annotate screenshots, record and trim screen videos, and collect console and network logs from the tested tab, then attach them to a test result in the Testomat.io browser extension.
type: article
url: https://docs.testomat.io/advanced/browser-extension/attachments/
head:
- tag: meta
attrs:
name: keywords
content: Testomat.io browser extension, screenshot, annotate, blur, full page screenshot, screen recording, trim video, console log, network log, attachments
---

Show what went wrong without leaving the page you're testing. Everything you capture is attached to the result of the test that's open in the panel.

**Before you start**

Open a test in a run and expand **Attachments**. If the buttons are greyed out, the reason is shown right below them: the test has no result yet, the run is finished, or the panel is in basic mode.

## Take a Screenshot

1. Click **Attach screenshot**. The panel captures the tab and opens the annotation editor on top of the page.
2. Mark up the picture with the tools below.
3. Click **Save** or press `Cmd/Ctrl+Enter`. The screenshot is attached to the result.

![The annotation editor over the tested page: a box around a field, a blurred address, then Save](./img/attachments/1-attach-screenshot.png)

Click **Keep original** to attach the screenshot without annotations, or **Discard** (`Esc`) to attach nothing. If you've already added annotations, the panel asks you to confirm.

| Tool | Key | What It Does |
|---|---|---|
| Select | `V` | Move an annotation, double-click a label to edit it, `Delete` removes it |
| Pen | `P` | Draw freehand |
| Arrow | `A` | Point at something |
| Line | `L` | Draw a straight line |
| Box | `R` | Frame an area |
| Ellipse | `O` | Circle an area |
| Highlight | `H` | Mark with translucent ink |
| Blur | `B` | Hide sensitive data |
| Text | `T` | Click, type, press `Enter` |
| Number | `N` | Add numbered markers 1, 2, 3; `S` / `M` / `L` set the size |
| Crop | `C` | Keep only the selected area |

You can edit any annotation until you click **Save**.

:::note

Blur can't be undone after you save. The blurred pixels are removed from the uploaded file, so it's safe to use on tokens and personal data.

:::

### Capture the Full Page

Turn on **Full page** in **Attachments** before you click **Attach screenshot**. The screenshot then covers the whole page, including the part below the scroll.

Full-page screenshots use Chrome's debugger, so Chrome shows a "…is debugging this browser" bar during the capture. That's expected — the bar closes by itself. On pages that block the debugger, such as `chrome://` pages, the panel takes a screenshot of the visible area and lets you know.

## Record Your Screen

You can start recording in three ways:

- click **Attach screen recording** in **Attachments**;
- press `Alt+Shift+R` on the page;
- right-click the page and choose **Testomat.io** → start recording.

While recording, the controls stay on the page: a timer, **Pause / Resume**, and **Stop**. Recordings are without sound. A recording stops on its own after 5 minutes or 50 MB.

![Recording the tab, stopping, cutting a range, and attaching the video](./img/attachments/2-attach-video.png)

:::note

When you start recording from the panel button, Chrome shows a "…is debugging this browser" bar until you stop. To avoid it, start from the page with `Alt+Shift+R` or the right-click menu.

:::

### Review and Trim the Recording

When you click **Stop**, a review window opens over the page with a player and a timeline.

1. Click **Play** to watch the recording.
2. To cut a part out, drag over it on the timeline. To undo a cut, click ✕ on its chip under the timeline.
3. Click **Attach to the result**. Only the parts you kept are uploaded.

![The review window over the page: player, timeline, and one cut range](./img/attachments/3-video-review.png)

Nothing uploads until you decide. If you close the review, the recording waits in the panel, and the button reads **Review recording…**. To delete the recording, click **Discard**.

## Collect Console and Network Logs

The panel can record console errors, warnings, and network requests from the tested tab. It keeps the last 60 seconds, so turn recording on **before** you reproduce the bug.

![Rec is on: the Rec button counts a 401 error, and the Console & network log lists it](./img/attachments/4-rec-log.png)

1. Open the test and click **Rec** in the panel header.
2. Reproduce the problem on the page. The **Rec** button counts errors as they happen. To see them, open **Console & network log** in the test. Each failed request shows its method, URL, and status.
3. Mark the test **Failed**. The log is attached to the result as a `.txt` file with Console and Network sections.

For failed requests, the log also saves the first 16 KB of the response body. URLs are saved without query parameters by default, so tokens in links stay out of the file. To change any of this, or the 60-second window, go to [Settings → Failure Log](/advanced/browser-extension/settings/#failure-log).

## Next Steps

- [Run Manual Tests](/advanced/browser-extension/run-tests/)
- [Settings](/advanced/browser-extension/settings/)
59 changes: 0 additions & 59 deletions src/content/docs/advanced/browser-extension/connect.md

This file was deleted.

49 changes: 0 additions & 49 deletions src/content/docs/advanced/browser-extension/console-network-log.md

This file was deleted.

106 changes: 66 additions & 40 deletions src/content/docs/advanced/browser-extension/create-tests.md
Original file line number Diff line number Diff line change
@@ -1,63 +1,89 @@
---
title: "Create tests"
title: Create Tests
description: Add tests by title, write test cases in Markdown, record test steps from your actions on a website, and add parameters in the Testomat.io browser extension.
type: article
url: https://docs.testomat.io/advanced/browser-extension/create-tests/
head:
- tag: meta
attrs:
name: keywords
content: Testomat.io browser extension, create test, bulk add, Markdown editor, step recorder, record steps, parameters, Polish with AI
---

The **Tests** tab browses the project's suites and lets you add test cases
without leaving the panel — by title alone, or written out in the editor.
Write new test cases while you explore the website. The **Tests** tab shows the project's suite tree with test counts.

## Browse
![The Tests tab with the suite tree](./img/create-tests/1-test-tree.png)

The tab shows the suite tree with test counts. Folders group suites;
clicking a suite opens its test list; clicking a test opens it — an
existing case renders read-only until you choose to edit.
## Add Tests by Title

![The suite tree](img/create-tests-tree.png)
1. Open a suite.
2. Type a title in **Add new test** at the bottom and click **Create** or press `Enter`.

## Add by title
![Adding one test by title, then several with Bulk](./img/create-tests/2-quick-add-tests.png)

Open a suite. The bar at the bottom adds a test **right here**:
The test is added to the suite, and you can fill it in later.

1. Type the title into **Add new test**, press **Create** (or Enter) —
the case appears in the list, empty for now.
2. Flip **Bulk** and the field becomes a list — one title per line, one
press, the whole list is created in order.
To add several tests at once, turn on **Bulk** and enter one title per line. The tests are created in the same order.

![One title, then a bulk list](img/create-tests-quick-add.gif)
## Write a Test in the Editor

Bulk add needs the full (not basic) mode.
1. Click **New test**. The editor opens.
2. Enter the title. If you started from the top of the tree, choose a suite.
3. Write the description and steps in Markdown.
4. Save the test.

## Write it out in the editor
![The test editor with Markdown steps and the Record steps, Polish with AI, and Parameters controls](./img/create-tests/3-extension-test-editor.png)

**New test** opens the editor: the title, a Markdown body with live
preview, and a suite picker if you started from the tree root. Steps are
plain Markdown lists; the toolbar records steps for you (see
[Step recorder](step-recorder.md)) and can hand the draft to your
Testomat.io AI to be rewritten — with an Undo.
To create a suite or folder, use the **+** buttons in the tree.

![The editor: Markdown, Record steps, Polish with AI, Parameters](img/create-tests-editor.png)
## Record Steps

New suites and folders are made from the tree's own + buttons.
Instead of typing steps, go through the flow on the website once. The extension turns your clicks, text entry, selections, and page navigation into readable steps.

## Parameters
1. Open the website you want to test, then start a new test in the editor.
2. Click **Record steps**. A recording bar appears in the bottom-right corner of the page.
3. Go through the flow. Each action appears in the test's steps a second after you do it.
4. Click **Stop** in the bar or in the editor.

A test that should run once per data row gets **parameters** — edited in
the same editor:
![Recording steps: actions on the page appear as steps in the editor](./img/create-tests/3-extension-test-editor.png)

1. Name the columns (say `role`, `email`).
2. Fill one example row per variant.
3. Write `${role}` and `${email}` in the title or steps.
Recorded steps read like this: *Click the "Add to cart" button*, *Type "pliers" into the Search field*. When a page opens, the extension adds an `Expected:` line under the step that opened it, for example *The "Cart" page opens*.

In a run, such a test shows one row per example, each marked on its own.
![Recorded steps in the editor, one with an Expected line](./img/create-tests/4-record-steps.png)

![A parametrized test rendered: the table under the steps](img/create-tests-params.png)
While recording:

## If it didn't work
- **+ Expected** adds your own expected result to the last step. Type it and press `Enter`.
- **Pause** stops recording for a moment, for example to do something that isn't part of the test. Click **Resume** to continue.
- After 50 steps, recording pauses and asks **Still recording?**. Click **Continue** to add 50 more.

- **Create is greyed out** — the title is empty, or the panel is in basic
mode (bulk add and the editor's server features need the session).
- **`${name}` shows literally in a run** — the test has no example rows
yet; add at least one in the editor's Parameters.
- **A new test is not in the web app yet** — give the panel a moment or
press Refresh there; the panel writes through the same API the web
reads.
![Test steps being recorded](./img/create-tests/5-steps-being-recorded.png)

### Sensitive Values

The extension recognizes passwords, card numbers, one-time codes, and similar fields, and doesn't save their values. The step names the field but not what you typed: *Type the password into the Password field*.

This works on a best-effort basis. If the website handles real payment or personal data, turn on **Never record entered values** in [Settings](/advanced/browser-extension/settings/#step-recorder) — then no typed value is saved.

### Polish with AI

If Testomat.io AI is enabled for your company, turn on **Polish with AI** next to **Record steps**. When you stop recording, the AI rewrites the steps in clearer language. To get the original wording back, click **Undo polish**.

If AI isn't available for your company, the switch stays off and tells you why when you click it, and nothing is sent. On a Testomat.io server without AI, the switch isn't shown.

## Add Parameters

Use parameters to run the same test with different data, such as different user roles.

1. In the editor, open **Parameters** and name the columns, for example `role` and `email`.
2. Add one row per data set.
3. Use `${role}` and `${email}` in the title or steps.

![A test with parameters: the steps and the example table under them](./img/create-tests/6-test-params.png)

In a run, the test shows one row per data set, and you mark each one separately.

## Next Steps

- [Run Manual Tests](/advanced/browser-extension/run-tests/)
- [Settings](/advanced/browser-extension/settings/)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading